用途:为 Claude Code 插件创建有效技能提供指导,适用于用户提出“创建技能”“向插件添加技能”“编写新技能”“改进技能描述”“组织技能”等需求。技能是模块化、自包含的包,为 Claude 补充专门知识、工作流与工具,可提供专门工作流、工具集成、领域专业知识与随附资源。
结构:每个技能由必需的 SKILL.md 和可选随附资源组成。SKILL.md 需 YAML frontmatter,其中 name 与 description 必填,另含 Markdown 指令。可选目录为 scripts/(可执行代码)、references/(按需载入上下文的文档)、assets/(输出所用模板、图标、字体等)。
设计原则:采用三级渐进式披露——元数据(名称+描述,常驻上下文,约 100 词)、SKILL.md 正文(技能触发时载入,少于 5k 词)、随附资源(按需载入,脚本可不读入上下文直接执行)。SKILL.md 正文建议 1500–2000 词,详细内容移入 references/。
创建流程:1)用具体示例理解技能触发方式;2)规划可复用内容(脚本、参考、资产);3)建立技能目录结构,插件技能直接建在 plugin-name/skills/skill-name/ 下,不用 init_skill.py:mkdir -p plugin-name/skills/skill-name/{references,examples,scripts},再创建 SKILL.md;4)编辑技能,先写可复用资源,再更新 SKILL.md;5)验证测试,检查 frontmatter、触发短语、写作风格、渐进式披露与引用文件,可用 skill-reviewer 代理审查;6)迭代改进。
写作要求:正文用祈使/不定式(动词开头)语言,避免第二人称;frontmatter description 用第三人称,包含具体触发短语,如“This skill should be used when the user asks to …”。
插件特性:技能放在插件 skills/ 目录,Claude Code 自动扫描并发现含 SKILL.md 的子目录;无需单独打包,随插件分发。本地测试可用 cc --plugin-dir /path/to/plugin。
限制:资料未提供收费、价格与平台支持信息。