用途:按统一规范从零创建 AI 技能,覆盖从单文件简单技能到多引用文件的复杂技能,要求每个技能职责唯一且自足。
主要能力:提供 SKILL-TEMPLATE.md 与 REFERENCE-TEMPLATE.md 模板;规定 frontmatter 结构(name、description 含 Trigger、metadata.version、metadata.type、skills 依赖等);要求 Critical Patterns 配 ✅/❌ 内联示例、Decision Tree、Edge Cases;复杂技能(40+ 模式或 4+ 子主题)拆分 references/ 并附 README.md;提供依赖矩阵、token 效率与校验指引。
使用方式:先读模板再创建,例如 cp skills/skill-creation/assets/SKILL-TEMPLATE.md skills/{skill-name}/SKILL.md;按复杂度选择结构;确定 type 与依赖;填写模板;添加模式与决策树;最后运行 ai-agents-skills validate --skill {name} 并 make sync。
适用场景:模式被反复使用需 AI 指导、项目约定不同于通用最佳实践、技术含多个子主题需组织时。
限制:琐碎或自解释模式、一次性任务不建议创建;type 决定允许的依赖;避免重复通用约定与传递性冗余依赖;复杂技能 SKILL.md 控制在 300 行内。具体校验细节与完整示例见资料所列参考文件。