用途:为 Claude Code 插件编写技能提供指导。技能是模块化、自包含的包,用于扩展 Claude 能力,提供专门知识、工作流与工具,把通用智能体转变为具备特定领域流程知识的专用智能体。技能可提供专门工作流、工具集成指令、领域知识(公司特定知识、schema、业务逻辑)以及打包资源。
主要能力与结构:每个技能包含必需的 SKILL.md 与可选打包资源。SKILL.md 含 YAML frontmatter 元数据(name 与 description 必需)及 Markdown 指令;可选资源包括 scripts/(Python/Bash 等可执行代码)、references/(按需载入上下文的文档)、assets/(用于输出产物的模板、图标、字体等文件)。
渐进式披露:采用三级加载机制管理上下文——元数据始终在上下文中(约100词);SKILL.md 正文在技能触发时载入(建议 1500–2000 词,不超过3000词);打包资源由 Claude 按需加载,脚本可执行而无需读入上下文。详细模式、API 文档、迁移指南、边界情况等应移入 references/,避免重复。
创建流程:理解技能的具体使用示例;规划可复用内容(脚本、参考、资源);创建目录结构,如 mkdir -p plugin-name/skills/skill-name/{references,examples,scripts} 并 touch plugin-name/skills/skill-name/SKILL.md;编辑技能内容;验证与测试;迭代改进。
写作要求:正文使用祈使/不定式(动词开头)与客观指令性语言;frontmatter 描述使用第三人称并包含具体触发短语,例如 This skill should be used when the user asks to "create a hook"。
插件特性:技能位于插件的 skills/ 目录;Claude Code 自动扫描发现含 SKILL.md 的子目录并加载元数据,插件技能随插件分发,无需单独打包 ZIP。可通过 cc --plugin-dir /path/to/plugin 本地测试。
限制:资料未提供该技能的价格、收费方式、平台支持范围与效果数据,暂未提供。