用途:指导用户创建和维护面向用户的智能体技能,写新技能、添加 SKILL.md、编写技能 frontmatter 与描述时使用。
主要能力:给出技能结构规范;规定 SKILL.md 必须精确命名,文件夹名用 kebab-case,技能文件夹内不得放 README.md;规定 frontmatter 中 name 须与文件夹名一致,description 为 1-1024 字符且同时说明做什么与何时使用;frontmatter 禁止 XML 尖括号,技能名不得含 claude 或 anthropic;提供描述示例与正反例,强调加入任务导向短语、触发条件与否定触发以避免过度触发。
结构:技能文件夹可含 SKILL.md(必需)、scripts/(可执行代码)、references/(按需加载文档)、assets/(模板等静态资源)。渐进式披露分三层:frontmatter 启动加载、SKILL.md 正文激活时加载、引用文件按需加载;建议正文少于 500 行,引用保持一级深度。
流程:先确定 2-3 个具体用例(触发语句、步骤、结果),再编写并验证:文件夹 kebab-case、SKILL.md 拼写正确、frontmatter 有 --- 分隔、描述含 what 与 when、指令可执行、含示例与故障排查、引用链接清晰。测试技能是否在明显与改写请求上触发、在无关话题上不触发。
迭代信号:触发不足可补充触发短语与任务关键词;过度触发可加否定触发、细化范围;执行不稳定可让指令更具体、加错误处理、对关键校验用脚本。
适用场景:开发者技能与面向用户的工具技能编写。限制:上述内容为资料所载规范,未提供具体安装命令、价格或更多运行环境信息。