用途:提供创建高效技能的指导,把具体使用场景转化为可复用的脚本、参考资料和资源,并最终打包为可分发的 .skill 文件。
主要能力:技能是模块化、自包含的包,可提供专业化工作流(特定领域的多步流程)、工具集成(特定文件格式或 API 的操作说明)、领域知识(公司专属知识、模式、业务逻辑)以及打包资源(脚本、参考文档、资产)。
结构:每个技能包含必需的 SKILL.md(YAML frontmatter 中的 name 和 description,以及 Markdown 正文),可选 scripts/(可执行代码)、references/(按需加载的文档)和 assets/(输出中使用的文件)。name 和 description 是 Claude 判断何时使用技能的唯一依据,因此应描述清楚技能做什么、何时使用;正文在技能触发后才加载。
创建流程:1) 用具体示例理解技能用途;2) 规划可复用内容;3) 运行 scripts/init_skill.py <skill-name> --path <output-directory> 初始化;4) 编辑技能(实现资源并撰写 SKILL.md,脚本需实际运行测试);5) 运行 scripts/package_skill.py <path/to/skill-folder> 打包(可加 ./dist 指定输出目录),打包前会自动校验 YAML、命名规范与目录结构;6) 依据真实使用迭代。
设计原则:精简优先,只补充 Claude 尚不具备的上下文;根据任务脆弱性和可变性设置自由度(高自由度文字说明、中自由度伪代码/参数化脚本、低自由度具体脚本);采用渐进式披露(元数据常在上下文、正文触发后加载、资源按需加载);SKILL.md 正文控制在 500 行以内,过长内容拆分到独立文件并从 SKILL.md 直接引用,引用保持一层深度,超过 100 行的参考文件加目录。
限制:技能内不应包含 README.md、INSTALLATION_GUIDE.md、QUICK_REFERENCE.md、CHANGELOG.md 等辅助文档;不提供无实际用途的额外文件;避免重复信息。
技术细节与更多资源:暂未提供。