用途：为 Claude Code 插件技能提供编写 SKILL.md 的规范指南，把通用 Claude 转变为具备专门工作流的专家。技能采用渐进式披露，分三层加载：元数据（name + description，始终在上下文，约100词）、SKILL.md 正文（触发时加载，约1500-2000词）、捆绑资源（按需加载）。
结构：目录以 skill-name/SKILL.md 为核心，可选 references/、examples/、scripts/、assets/。最小技能只需 SKILL.md，只创建实际需要的目录。
前置元数据：以 --- 开头，name 必填且须与目录名一致（kebab-case）；description 必填，须同时包含 PROACTIVELY activate for: (1)...(N)... 具体触发项枚举和 Provides: 能力清单。描述面向“何时使用”而非“做什么”，目标400-1000字符，上限1024字符。缺少前置元数据属 P0 缺陷，永不触发。
正文：用祈使句（动词开头），按标题、Overview、Quick Reference、Core Content、Additional Resources 组织；理想1500-2000词，硬上限3000词，超出则移到 references/。
去重规则：同一 SKILL.md 内不得重复表格或内容块；SKILL.md 与 references/ 中信息只存一处。粘贴超过约3行的块前，用 grep -rn "FIRST_DISTINCTIVE_LINE_OF_THE_BLOCK" skills/ agents/ commands/ README.md 检查：0处可加，1处应抽取到 skills/_shared/<topic>.md 或 references/<topic>.md 并替换为指针，2处以上按 P1 缺陷处理。
资源类型：references/ 为按需文档（每份2000-5000+词，超1万词在 SKILL.md 提供 grep 模式）；examples/ 为可复制运行的代码；scripts/ 为可执行工具（不加载进上下文）；assets/ 为输出资源。
自动发现：Claude Code 扫描 skills/ 下含 SKILL.md 的子目录，启动加载元数据，按描述匹配触发加载正文，再按需加载 references/examples，无需配置。具体创建流程与常见错误详见 references/creation-process-and-mistakes.md。