用途:为 Claude Code 插件创建有效技能(skill)提供指导。技能是模块化、自包含的包,通过提供专门知识、工作流和工具扩展 Claude 能力,相当于特定领域的“入门指南”。
主要能力与原则:强调简洁,上下文窗口是公共资源,只补充 Claude 尚不具备的信息,优先用简洁示例而非冗长解释;按任务脆弱性设置自由度,高自由度用文本指令,中自由度用带参数的伪代码或脚本,低自由度用具体脚本。
技能结构:每个技能包含必需的 SKILL.md(YAML frontmatter 含 name、description 必填,when_to_use 可选,以及 Markdown 指令)和可选资源目录 scripts/(可执行代码)、references/(按需加载的文档)、assets/(输出用文件)。description 说明技能做什么,when_to_use 写触发短语与示例请求,两者合并截断于 1536 字符。
渐进式披露:分三级加载——元数据始终在上下文(约 100 词)、SKILL.md 正文在触发时加载(少于 5k 词)、资源按需加载。SKILL.md 正文建议 1500-2000 词,详细内容移至 references/。
创建流程:理解具体用例、规划可复用内容、创建目录结构、编辑技能、验证测试、迭代。插件技能位于 plugin-name/skills/skill-name/,Claude Code 自动发现,无需打包。可用 --plugin-dir 本地测试:cc --plugin-dir /path/to/plugin。
限制:不应包含 README.md、INSTALLATION_GUIDE.md、QUICK_REFERENCE.md、CHANGELOG.md 等多余文档;正文使用祈使/不定式而非第二人称。具体收费、价格、平台等信息暂未提供。