各宿主 Skills 差异对比
目录
- 这篇对比解决什么问题
- 先对齐：没有「完全通用」的 Skill 包
- 总览表：通用专题 / OpenClaw / Hermes / 插件内 Skills
- OpenClaw 侧：工作区与路径
- Hermes 侧：Skills Hub 与迁移
- 开放标准 agentskills.io 扮演什么角色
- 插件（Plugin）内的 Skills 有何不同
- 迁移与复用：什么能直接搬、什么要改
- 选型建议（一句话）
- 原文与站内链接
这篇对比解决什么问题
很多同学会问：「Skills 与插件专题」里写的规范，和 OpenClaw、Hermes 里说的 Skills 是不是同一套？
这篇用一张对照表 + 分宿主说明把差异说清楚，避免把「通用写法」和「某产品加载规则」混成一件事。
先对齐：没有「完全通用」的 Skill 包
在工程现实里，Skill 的正文（流程、步骤、质量标准）往往可以跨宿主复用或略改；但 路径、发现方式、权限、与工具链的绑定 由各自宿主决定。
因此：「统一」的是方法论与文档结构；「不统一」的是安装位置与运行时行为。
下面用一张简图表达「同一套 SKILL 正文，可能落在不同容器里」：
总览表：通用专题 / OpenClaw / Hermes / 插件内 Skills
| 维度 | 本专题「通用 Skills」 | OpenClaw | Hermes | Plugin 内 Skills |
|---|---|---|---|---|
| 定位 | 写法、治理、版本、与插件关系 | 个人助手工作区能力 | 自托管 Agent + 学习闭环叙事 | IDE/Agent 宿主里的扩展包 |
| 典型路径 | 不固定（教你怎么写） | ~/.openclaw/workspace/skills/<skill>/SKILL.md（见官方） | ~/.hermes/skills/... 等（见官方与迁移说明） | <plugin>/skills/<skill>/SKILL.md |
| 与标准 | 对齐 agentskills.io 的叙事 | 以官方文档为准 | README 提 agentskills.io 兼容方向 | 随插件版本发布 |
| 迁移 | — | — | hermes claw migrate 可导入 OpenClaw 技能等 | 随插件安装/卸载 |
OpenClaw 侧：工作区与路径
- 官方入口：Skills（OpenClaw）。
- 典型特征：Skill 挂在 Gateway + 工作区 叙事下，与
AGENTS.md/SOUL.md等同一套「个人助手」配置共存；渠道、会话、工具权限由 OpenClaw 的 Gateway 策略约束。 - 与本专题关系：本专题的 SKILL.md 模板可直接用于 OpenClaw，但必须放到官方文档指定的目录结构，并遵守其安全与工具策略（见 Security）。
站内延伸：OpenClaw 专题、上下文与记忆管理策略。
Hermes 侧：Skills Hub 与迁移
- 官方入口：Skills（Hermes） 与 README 中的 Skills Hub / agentskills 相关描述。
- 典型特征：Skill 与 记忆、检索、会话 强耦合叙事；从 OpenClaw 迁移时，技能会进入指定目录（如
openclaw-imports等，以官方说明为准）。 - 与本专题关系：正文写法仍可参考本专题 02、03；上线前要按 Hermes 的 工具/审批/安全 文档再校一遍。
站内延伸：Hermes-Agent 专题。
开放标准 agentskills.io 扮演什么角色
agentskills.io 提供的是跨工具互操作与元数据方向的公共叙事（具体字段与校验以站点为准）。
它不是替某个产品实现「自动安装到所有宿主」——各宿主仍需实现自己的加载器与权限模型。
实践建议：把 Skill 写成「标准友好」结构（清晰元数据、输入输出、版本），便于后续进 OpenClaw/Hermes/插件任意一侧。
官方文档 Adding skills support 面向宿主实现者，其中常见约定包括：
- 目录发现：在「项目」与「用户」等作用域下扫描含
SKILL.md的子目录；.agents/skills/被多客户端用作互操作约定（规范本身只定义包内结构，不强制磁盘路径）。 - 同名冲突：普遍约定项目级 Skill 覆盖用户级；同作用域内同名应记录告警并采用稳定优先级规则。
- 信任：来自克隆仓库的 Skill 可能不可信，部分实现会要求「工作区已标记为可信」才加载项目级 Skill。
更系统的索引与链接表见 Agent Skills 规范对照与宿主接入。
插件（Plugin）内的 Skills 有何不同
- 分发方式：Skill 随 Plugin 包 安装，而不是单独拷贝到
~/.openclaw/workspace。 - 版本绑定：Skill 变更通常与 插件版本号 一起发布、一起回滚。
- 发现方式：由宿主 UI / marketplace 列表展示（概念见本专题 插件概念与 manifest）。
迁移与复用：什么能直接搬、什么要改
| 内容 | 通常可直接复用 | 通常要改或核对 |
|---|---|---|
| 流程步骤、质量清单、失败兜底 | 是 | 若宿主工具名不同 |
| 输入输出 JSON 示例 | 是 | 字段名与宿主工具 schema 对齐 |
| 目录路径、加载名 | 否 | 按目标宿主文档放置 |
| 密钥与内网地址 | 否 | 一律按环境替换，勿写进 Skill 正文 |
OpenClaw → Hermes：可用官方 hermes claw migrate 做迁移与预览（见 Migrating from OpenClaw）。
选型建议（一句话）
- 只关心「怎么把 Skill 写成团队资产」：以本专题 01～03 为主。
- 已选定 OpenClaw/Hermes：在遵守本专题规范的前提下，以对应官方文档的路径与策略为准。
- 要给 IDE/Agent 发安装包：用 Plugin + 内嵌 Skills，版本与 manifest 跟插件走。
原文与站内链接
| 说明 | 链接 |
|---|---|
| agentskills.io | https://agentskills.io |
| What are skills? | agentskills.io/what-are-skills |
| Specification | agentskills.io/specification |
| Adding skills support（宿主） | agentskills.io/.../adding-skills-support |
| 本站规范对照 | Agent Skills 规范对照与宿主接入 |
| OpenClaw Skills | docs.openclaw.ai/tools/skills |
| Hermes Skills | hermes-agent.nousresearch.com/.../skills |
| 本专题 Skill 模板 | Skill 编写规范与 SKILL.md 模板 |
| 本专题 Skill 治理 | Skill 治理、测试与版本发布 |