用途:用于创建、编辑、审查或调试 agent 的 SKILL.md 文件,并提供触发条件、示例、限制与安全说明的质量指导。
核心内容:一个 Agent Skill 是包含 SKILL.md(YAML frontmatter + markdown 指令)及可选 scripts/、references/、assets/ 子文件夹的目录。技能采用渐进式披露三阶段加载:发现阶段常驻上下文(约 100 tokens 的 name + description),匹配后加载正文(<5000 tokens),执行阶段按需读取引用文件或运行脚本。
两种设计范式:能力原语(对确定性 CLI/脚本的薄封装)与过程原语(纯提示工程编码方法论,如 TDD、代码审查)。
写作要点:description 是路由契约,包含做什么、何时用、与相关技能的区别,不要概括完整流程;正文保持精简,优先 bash 命令示例,将确定性逻辑放入脚本;按任务脆弱度匹配指令严格度;构建验证循环;行动前检查状态;引用文件保持一层深度并加目录。
限制与安全:需审计 scripts/ 的外发网络调用与文件访问、检查 references 中的提示注入、验证名称非仿冒、在沙箱中先运行、固定版本。未提供具体安装命令、收费或平台信息。