用途:指导创建有效、可移植的技能,把可复用工作流一次性编码后稳定应用。技能是文件夹化的指令集,可在 Claude.ai、Claude Code 和 API 间通用。
结构:技能文件夹包含必需的 SKILL.md(YAML frontmatter 加 Markdown 指令),以及可选的 scripts/(确定性任务的可执行代码)、references/(按需载入上下文的文档)、assets/(输出用模板、图片、字体)。不要包含 README.md、CHANGELOG.md 等辅助文档。
核心原则:上下文预算上,只写 Claude 尚不知道的内容,SKILL.md 正文硬性上限 5000 词,超出部分移入 references/;自由度按任务脆弱性匹配,从文本引导到精确脚本;采用三层渐进披露(frontmatter 常驻、正文触发后载入、资源按需载入),正文超过 300 行应拆分并说明何时读取;技能需可组合、可移植,不硬依赖特定环境工具。
工作流:1)理解,收集 2-3 个具体用例,明确触发、步骤与结果;2)规划,判断哪些内容每次重写,分别归入 scripts/、references/、assets/;3)构建,创建文件夹,先写资源并测试脚本,再写 SKILL.md,可用 scripts/init_skill.py <skill-name> --path <output-directory> 脚手架,并按 references/validation-checklist.md 校验;4)测试,做正负触发测试与真实任务功能测试,与无技能基线对比;5)迭代,诊断欠触发、过触发或执行失败并修复。
打包:将技能打包为 .skill 文件(扩展名为 .skill 的 zip),可用 scripts/package_skill.py <path/to/skill-folder> [output-directory] 自动校验打包,否则手动压缩并确保 SKILL.md 位于压缩包根目录。
参考指南:description-authoring.md、workflows.md、output-patterns.md、testing-iteration.md、validation-checklist.md、troubleshooting.md。
限制:资料未提供具体收费、价格、平台支持范围或效果数据;成功标准为 10 个相关提示中 9 个触发并输出一致,属资料所述目标而非保证。