用途:该技能用于设计、审查和改进 Claude/Codex 技能,帮助新技能正确触发、稳定执行并保持简洁。
主要能力:以渐进式披露组织内容——frontmatter(name、description)用于触发选择,SKILL.md 主体承载核心工作流,references/ 存放按需加载的深层细节。强调技能可组合、避免假设自身是唯一活跃技能,并对脆弱的校验逻辑优先使用确定性脚本。
使用方式:工作流为先定义 2-3 个具体用例,再撰写触发力强的前置元数据,设计可复用资源(scripts/、references/、assets/),编写可操作的指令与错误处理,最后运行触发/功能/性能测试并据信号迭代。frontmatter 的 name 用 kebab-case 且与文件夹名一致;description 需同时说明做什么和何时使用,公式为[做什么]+[何时使用]+[关键能力],可加否定触发条件减少误触发。
资源规则:SKILL.md 保持紧凑并链接到 references/;技能文件夹内避免多余文档(如 README.md、changelog)。
测试:分触发测试(10-20 条提示中约 90% 相关提示可触发)、功能测试(输出、工具调用、错误处理、边界)与性能对比(有无技能的澄清轮次、失败调用、token 用量、完成质量)。
脚手架:默认路径 .agents/skills:bash scripts/new_skill.sh <skill-name>;指定 .claude/skills:bash scripts/new_skill.sh <skill-name> --path .claude/skills。
限制与排错:缺失 SKILL.md(须精确命名)、无效 frontmatter、非法技能名、指令未被执行、行为缓慢等均有对应修复建议。资料未提供具体平台支持范围、收费与价格信息。