用途:指导创建有效的 Claude 技能(Skill),或在用户想新建、更新扩展 Claude 能力的技能时使用。技能是模块化、自包含的包,通过专门知识、工作流和工具扩展 Claude 能力,相当于特定领域的“上手引导”。
主要能力与内容:
- 技能构成:必需 SKILL.md(含 YAML frontmatter 的 name、description 与 Markdown 正文),可选 scripts/(可执行代码)、references/(按需加载的文档)、assets/(输出用模板、图标、字体等)。
- 核心原则:简洁优先,只补充 Claude 不具备的上下文;按任务脆弱性设置自由度(高自由度文本指令、中自由度伪代码或带参脚本、低自由度固定脚本)。
- 渐进式披露:元数据常驻上下文,SKILL.md 正文在触发后加载(建议 500 行内),捆绑资源按需加载;提供高层指南加引用、按领域组织、条件细节三种模式,引用保持一层深度,长文件加目录。
- 创建流程:用具体示例理解技能、规划可复用内容、运行 scripts/init_skill.py <skill-name> --path <output-directory> 初始化、编辑资源与 SKILL.md、运行 scripts/package_skill.py <path/to/skill-folder> 打包(可指定输出目录如 ./dist),再按实际使用迭代。
- 写作要求:正文用祈使句;description 需同时说明技能做什么及何时使用,触发信息放在 frontmatter 而非正文;不添加 README、安装指南等多余文档。
适用场景:为特定领域、文件格式、API、公司业务逻辑或重复性任务构建专用技能。
限制:资料未提供具体收费、价格、平台支持范围与效果数据;打包脚本的完整校验细节在资料中未完整给出。