Skills 与插件专题
目录
本专题讲什么
在 AI Agent 工程里，**Skill（技能）**通常指「可复用的流程与约束说明」，常以 SKILL.md 等形式被助手加载；**Plugin（插件）**通常指「宿主环境里的扩展包」，带有 manifest（例如 Codex 的 .codex-plugin/plugin.json）、可选 Skills/Hooks/MCP 等目录。
本专题分篇说明：Skill 的体系与编写规范、治理与发布；以及 Plugin 的目录结构、manifest、脚手架与和 Skill/MCP 的组合关系。内容兼顾通用方法与常见工具链（如 agentskills.io 所描述的标准化叙事）。
和 OpenClaw / Hermes 的关系
本专题是通用写法与治理；各产品自己的路径、加载方式与安全策略不同，不是「同一套文件无差别通用」。请先读 各宿主 Skills 差异对比，再对照各官方文档落地。
Skill 与 Plugin 的区别（先对齐概念）
| 概念 | 典型形态 | 解决的问题 |
|---|---|---|
| Skill | 多为 Markdown/文档 + 少量脚本引用 | 把「怎么做」沉淀成可引用步骤，降低对话中的重复说明 |
| Plugin | 目录 + manifest + 可选代码/资源 | 把「能力包」安装到 IDE/Agent 宿主，统一发现、权限与版本 |
二者常一起出现：Plugin 里可以内置多个 Skills；但 Skill 也可以独立存在于工作区而不依赖 Plugin。
适合谁
- 要在团队内统一 RAG、评测、发布、值班 等重复流程的工程师。
- 要为 Codex/Cursor 类环境 维护可安装扩展的人。
- 已使用 OpenClaw/Hermes 等助手，需要把工作区 Skills 写得可维护的人（可对照 OpenClaw Skills、Hermes Skills）。
阅读顺序
- Skill 体系概述与生态位
- 各宿主 Skills 差异对比（OpenClaw / Hermes / 插件 / 通用标准）
- Skill 编写规范与 SKILL.md 模板
- Skill 治理、测试与版本发布
- 插件（Plugin）概念与 manifest
- 插件脚手架与工程集成
- Agent Skills 规范对照与宿主接入（与 agentskills.io 逐项对照，可选）
外部参考
- agentskills.io — Skill 开放标准与生态说明（以站点为准）。
- 官方文档索引（便于爬虫/LLM 拉全站）：llms.txt。
- OpenClaw 文档：Skills
- Hermes 文档：Skills
agentskills.io 文档地图（速查）
| 页面 | 链接 |
|---|---|
| Home | agentskills.io/home |
| What are skills? | what-are-skills |
| Specification | specification |
| Quickstart | skill-creation/quickstart |
| Best practices | skill-creation/best-practices |
| Optimizing descriptions | skill-creation/optimizing-descriptions |
| Evaluating skills | skill-creation/evaluating-skills |
| Using scripts | skill-creation/using-scripts |
| Adding skills support | client-implementation/adding-skills-support |
| Client showcase | clients |