[Owlbay]

做了什么

把已收录的全部 skill 按功能放到 vendor/<category>/<upstream-id>/，并补上 emilkowalski/skills 里之前未收录的 6 个独立 skill：write-swift、pick-ui-library、prototype、mobile-native、break-ui、ask-sonner。

vendor/ 仍只由 scripts/sync-upstream.py 写入。作者留在 skills.json，锁定提交留在 skills.lock.json。同一上游跨多个分类时，每个分类目录里各有一份该上游的许可证文件。

安装结果不变：用户级 skill 仍装到 ~/.claude/skills/<name>/，项目级（impeccable）仍装到目标项目的 .claude/（skill、agents，以及改写后的 hooks）。路径里没有分类层。

project/docs/design/ 是新项目模板里的界面风格，继续用 docs/design/ 这个路径。外部资料摘要改到 docs/references/interface-design/，与界面设计分类对齐。

分类

每个 skill 只归一类。分类 id 用英文 kebab-case。

分类	职能
interface-design	布局、配色、排版、表面、文案，以及整页界面的打磨
motion	动效的实现、评审、审计、性能、用语，以及手势与弹簧
mobile	让网页在手机上少一点浏览器感
accessibility	键盘、焦点、ARIA、表单和读屏
review	界面评审、指南核对，以及用场景或最坏数据把界面压坏
prototyping	为同一块界面做出多个可切换的版本
frontend-libraries	按既定清单选库，并正确接上具体的库
language	具体编程语言的写法和工程约束

interface-design

• better-colors、better-layout、better-typography、better-ui、better-writing、explain-interface（jakubkrehel）
• emil-design-eng（emilkowalski）：总的界面打磨和组件取舍，动效判断是其中一部分；专门的动效流程放在 motion
• impeccable（pbakaus，项目级）：设计、改版、打磨前端界面；评审是它的一种用法，主职是把界面做出来

motion

• animate、animate-expo、animation-performance、animation-vocabulary、find-animation-opportunities、improve-animations、review-animations、apple-design（emilkowalski）
• animate-expo 写的是 React Native / Expo 上的动效，归动效
• apple-design 的主体是手势、弹簧和可打断动效，归动效
• 动效评审和全库审计跟实现放在一起，方便按主题找

mobile

• mobile-native（emilkowalski）：粘滞悬停、点击高亮、100vh、输入框缩放、安全区

accessibility

• better-accessibility（jakubkrehel）

review

• better-interface、interface-review、break（jakubkrehel）
• web-design-guidelines（vercel）
• break-ui（emilkowalski）

prototyping

• variant（jakubkrehel）
• prototype（emilkowalski）

frontend-libraries

• pick-ui-library、ask-sonner（emilkowalski）

language

• write-swift（emilkowalski）

名称与功能重叠

目录名和 SKILL.md 里的 name 都没有冲突，28 个 skill 的名称互不相同，因此照收。

功能接近、名称不同的有两组：

• break（jakubkrehel）把组件放上临时页，铺开它会遇到的场景。break-ui（emilkowalski）用真实的最坏数据去压同一块界面。
• variant（jakubkrehel）留在真实页面上做变体。prototype（emilkowalski）在隔离的原型面上发散，选定后再合进产品。

同步范围

• emilkowalski 的上游提交仍是 2d22863。根目录的 performance-cheatsheet.md 不写入 vendor/：它不是 skill，其中的动效性能要点已由 animation-performance 覆盖。$syncNote 只保留这一句。
• jakubkrehel 改为按清单同步单个 skill 目录。build-design、state-machine、teardown 原来会跟着整个 skills/ 目录进 vendor/，但它们不在安装清单里，这次不再写入，也不会被安装。
• impeccable 的上游 HEAD 从 3e3a917 前进到 7510e23，锁定提交已跟随。内容上 reference/hooks.md 补了 Hermes Agent 的说明。

检查

• scripts/check.sh：通过
• scripts/sync-upstream.py --check：通过（四家上游都已是最新）
• scripts/install-skills.py user --dry-run：27 个用户级 skill，目标都是 ~/.claude/skills/<name>
• 项目级安装到临时目录：impeccable 的 skill、4 个 agent 和 hooks 进入 .claude/，${CLAUDE_PLUGIN_ROOT} 被改写成 ${CLAUDE_PROJECT_DIR}/.claude