SKILL.md 技能包协议——一份 manifest + prompt + 工具列表

技能是一种组合

一个技能（Skill）是一组复合能力——"研究这个主题并写一份简报"、"review 这段代码并 comment"、"把 git log 整理成每日 standup update"。

它不是一个单一工具（像 shell 或 search_web），而是多个工具的编排 + 一段 prompt 模板 + 可选的脚本和参考资料。

技能包的结构

一个技能包就是一个目录，核心是一份 SKILL.md：

my-skill/
  SKILL.md         ← 必选，技能的 manifest + prompt + 工具列表
  LESSONS.md       ← 可选，让技能从使用中学习
  templates/       ← 可选，prompt 里引用的模板文件
  scripts/         ← 可选，技能需要的辅助脚本
  references/      ← 可选，参考资料

SKILL.md 里有什么

部分	说明
manifest	技能名称、版本、作者、描述、适用场景、工具列表
prompt	这个技能的 prompt 模板——Agent 调用技能时注入
参数声明	技能接收哪些输入参数（用户可以在调用时填）
工具依赖	执行这个技能需要哪些底层工具

运行时管道

当 Agent 在对话里决定调用一个技能时，运行时做这些事：

读取 SKILL.md，解析 manifest 和 prompt 模板
把用户输入填进模板的参数位置
检查依赖的工具是否都可用（Tool Guard 规则下）
用填充后的 prompt 继续执行 Agent 推理链
执行完成后，Agent 自动把结果以 /skill 形式展示

五种技能

MateClaw 区分五种技能类型（manifest 里 type 字段决定）：

Builtin：内置技能，随 MateClaw 发布
User：用户自己写的技能，放在工作空间里
Market：从技能市场（ClawHub）下载的
ACP：通过 ACP 协议连接的外部技能服务
MCP-wrapped：把 MCP Server 包装成 Skill 形式

模板向导

不想从白纸写起？创建技能时可以从八个起步模板中选：内容创作、代码 review、数据分析、研究简报、文档整理、会议纪要整理、翻译、自动化脚本。选一个、改 prompt、换工具依赖——快速出能用的技能。