用途:在 skills/<name>/ 下创建或更新紧凑的智能体技能,使技能在调用时只加载所需行为。适用于被要求编写、添加或修改技能时;不用于审计技能库。
主要能力:先澄清缺失的关键信息(能力、触发条件、非触发条件、工具或脚本需求、可移植性);选择唯一的 kebab-case 名称;将 SKILL.md 写成操作卡,说明运行什么、何时运行、输出含义与常见陷阱;仅在能消除重复确定性工作时添加辅助文件;压缩一次并添加一行 README 记录,未获要求不提交。
使用方式:SKILL.md 采用 frontmatter 模板,包含 name 与 description;description 是路由面,优先优化,用 1-3 句第三人称现在时,第一句写明具体能力,第二句以 Use when 开头列出真实触发短语、文件类型、工具或上下文,宽泛领域需加 Do NOT use。正文保留可运行命令或精确工作流步骤、常见首次使用阻塞的设置检查、紧凑输出契约、路由边界与安全陷阱、每个命令或概念一个强示例;删除复述描述的概述、安装/贡献/隐私/排障章节、复制的 CLI 帮助与模式、重复提示示例等。工具类技能将确定性工作放入 scripts/ 或现有可执行文件,SKILL.md 作为调用菜单加输出形态与注意事项,优先 30-60 行。工作流类技能保留视角、决策顺序与输出契约。共享技能面向 Codex、Claude Code 和 Pi,保持任务知识、验收标准与可执行辅助共享,优先使用现有 CLI。显式激活时,Claude/Pi 用 disable-model-invocation: true,Codex 用 policy.allow_implicit_invocation: false。
限制:资料未提供具体安装命令、价格、平台支持范围或效果数据;最终检查要求名称唯一 kebab-case、description 含具体 Use when 与必要 Do NOT use、SKILL.md 约 120 行以内、辅助文件被调用而非在正文重复、正向跨技能指针必须指向 skills/ 中存在的技能、仅代理或操作系统要求需在 compatibility: 中声明。