ishane.cn

allowed-tools字段 allowed-tools字段是SKILL.md中唯一直接控制 Agent 运行时行为的字段：它本质上是在为Skill划定一个"工具沙箱"，决定Agent激活这个 Skill后能用什么、不能用什么。如果说description控制的是"什么时候激活"，那allowed

metadata 字段 metadata字段是SKILL.md中的**"万能收纳箱"**：当其他5个标准字段（name、description、license、compatibility、allowed-tools）装不下你的信息时，所有额外内容统统往这里塞。 metadata是什么 metadat

license字段 license用于声明该Skill的开源许可协议，告诉使用者"这个技能可以怎么用、能不能商用、需不需要署名"等法律问题。 规范 可选字段，不填也不会影响 Skill 的正常运行 填写内容为许可证名称或对捆绑许可证文件的引用 无字符数限制说明，但建议保持简短 常见写法 # 方式一：

description字段 description是SKILL.md中最具战略价值的字段——它直接决定了Agent能不能找到你、会不会用你。如果说name是Skill的"身份证号"，那description就是它的"简历摘要"，Agent在海量 Skill中筛选时，完全依赖它来判断"这个Skill跟

在《认识Agent skill》一文中，我们学习到skill的结构如下； 目录结构 skill必须至少包含一个文件：SKILL.md my-skill/ ├── SKILL.md # 必填: 元数据(name、description) + 技能描述 ├── scripts/

技术定义 Agent Skills是一种轻量级的开放格式，用于通过专业知识和工作流扩展AI Agent的能力。核心是一个包含了skill.md文件的文件夹，如果只有skill.md文件也是可以的；这个文件夹包含了包含了元数据和技能描述（这两项必须要有），以及脚本、参考资料、模板和其他资源等。 整个技