awesome-hermes-skills技能开发教程:如何编写并发布你的第一个SKILL.md
awesome-hermes-skills技能开发教程:如何编写并发布你的第一个SKILL.md
awesome-hermes-skills 是 Nous Research 旗下 Hermes Agent 生态的精选技能目录,收录了 350+ 个 Hermes 技能、插件与记忆后端。本教程带你用 5 步完成从零到上架的完整流程:安装 Hermes 技能、理解 SKILL.md 结构、编写你的第一个技能文件,最终把成果提交进 awesome-hermes-skills 目录。
一、先认识项目:Hermes 技能生态有多大?
Hermes 是目前少数具备真正"学习闭环"的智能体:它会从你的工作流中自己沉淀技能、检索历史对话。而一个 Hermes Agent 有多强大,取决于你给它装了多少 Hermes 技能。
当前目录的规模一览:
| 类别 | 数量 | 说明 |
|---|---|---|
| 内置技能(built-in) | 82 | 安装 Hermes 即可用,无需额外操作 |
| 可选技能(optional) | 117 | 随包附带、默认关闭,按需开启 |
| 社区技能与插件 | 169 | 经过人工审核的社区作品 |
完整清单就在 README.md 中,按"媒体转录、搜索研究、开发、DevOps、金融、多智能体"等 14 个社区分类组织。每个条目都带一个成熟度标签,让你知道自己在装什么:
| 标签 | 含义 |
|---|---|
| production | 稳定、有文档、持续维护,可放心使用 |
| beta | 可用但仍在演进,可能遇到毛边 |
| experimental | 概念验证,好玩但别依赖它 |
| built-in | Hermes 自带,随包安装 |
二、第一步:安装一个技能,感受"技能"到底是什么
不要一上来就装一堆。官方推荐三步走:跑通 Hermes → 装第一个技能 → 选一个工作流升级。
装一个技能只需要一条命令,例如目录里被重点推荐的 YouTube 技能:
hermes skills install skills-sh/ZeroPointRepo/youtube-skills/skills/youtube-full
装好后对它说"总结频道最近 5 个视频",30 秒后你就会明白技能的价值。
理解了这一点,你就理解了 SKILL.md 的本质:技能就是一个 Markdown 文件,里面写着"什么时候该用我、该怎么做、做到什么程度算完",智能体读进去,照着执行。
三、SKILL.md 解剖:如何编写你的第一个技能
一个技能就是一个目录,核心是其中的 SKILL.md 文件,安装在 ~/.hermes/skills/<技能名>/ 下。它的结构分两部分:
1. 头部(frontmatter):元信息
name: 技能名(小写连字符,如 weekly-review)
description: 一句话说清"做什么 + 为什么值得装"
2. 正文:写给智能体看的操作手册,建议包含四块内容:
- 触发条件:什么场景下该调用这个技能
- 执行步骤:清晰的步骤化指令,必要时附命令示例
- 输出格式:期望产出长什么样
- 停止条件:做到什么程度收手(这一条很多人漏掉,而它最影响稳定性)
两个新手友好的技巧:
- 🛠️ Hermes 自带一个内置技能
hermes-agent-skill-authoring(见 README.md 中 Software Development 分类),专门帮你编写仓库内的SKILL.md,包括 frontmatter 和结构,可以直接让 Hermes 自己带你写。 - ✍️ 描述写得像说明书,别写营销文案——用现在时、讲清楚它做什么、用户为什么需要它。
四、发布四步走:把技能提交进 awesome-hermes-skills
写好自己的技能后,想让它被更多人发现?进入 awesome-hermes-skills 的完整流程只有四步:
1. 准备一个"有内容"的公开仓库
这是硬性门槛:仓库里必须有真实的 SKILL.md(或 plugin.json),外加一份能说明它做什么的 README。只有标题没有内容的仓库不会被收录,链接必须公开、可访问、且 6 个月内有过提交。
2. 先搜,避免重复
打开 README.md 用 Ctrl-F 搜一下你的仓库名——"已经收录"是拒绝原因之一,搜索一次能省掉一轮来回。
3. Fork、建分支、加一行
条目格式是固定的一行,照抄这个形状即可:
- 名称 by 作者 — 一行描述。 **[标签]**
注意细节:描述与标签之间用带空格的破折号 —;一个仓库里有 20 个技能、你只推荐其中一个时,链接直接指向那个技能目录。
4. 选对位置,提交 PR
按显示名称的字母顺序(忽略大小写)插入对应小节。社区技能按类型分区,常见分区包括:
| 分区 | 收什么 |
|---|---|
| 💻 Dev & Skill Authoring | 编码工作流、技能构建器、开发工具 |
| 🔍 Search & Research | 网络搜索、论文、深度研究 |
| 📊 Productivity & Tasks | 规划、笔记、任务管理 |
| 🔌 Plugins | 给智能体本身加工具/命令的插件包 |
| 🧠 Agent Profiles | 人格 + 记忆 + 技能的整体配置 |
选不准就挑最接近的并在 PR 里说明——放错分区不是被拒的理由。PR 模板会问 5 个是/否问题,如实回答是合并最快的方式;能一次只加一个条目就尽量一次一个。
五、验收标准:什么会被合并,什么会被拒绝
完整规则见 CONTRIBUTING.md,核心是"四条全满足才合并":
- ✅ 链接可解析(公开、不是 404)
- ✅ 背后有真东西(真实
SKILL.md+ README) - ✅ 在被维护(近 6 个月有提交)
- ✅ 目录里还没有(先搜过)
而拒绝只有四种理由:死链、无实质内容、垃圾信息、重复——而且维护者会明确告诉你中了哪条,改好随时欢迎回来。
给新人的定心丸:📌 格式错误不会让 PR 被拒。放错字母序、标签没加粗、破折号打错,维护者会顺手修好再合并。别让一个逗号挡住你提交 PR。
六、进阶:从 Skill 到跨平台插件
如果你的技能想走出 Hermes,可以了解一下 README.md 中"Skills → Plugins"一节介绍的 Agent Plugins 开放标准:插件就是一个目录,包含 plugin.json、skills/<技能名>/SKILL.md 等文件。已经写好 SKILL.md 的你,其实已经完成了一大半——同一个技能可以原样放进插件,在更多智能体运行环境中加载。
七、相关文件与安全提醒
📁 项目内的关键文件,都给了相对路径方便你直接查看:
- README.md:完整技能清单与分类索引
- CONTRIBUTING.md:条目格式、标签定义与提交规范
- entry-health-report.md:每周自动生成的条目健康检查报告
- llms.txt:面向 AI 智能体的目录使用说明
⚠️ 最后一条安全须知(同样写在 README.md 中):目录里的技能是精选过的,但不是审计过的。技能会以安装者的权限运行,安装前请读源码;生产环境建议锁定到具体提交而非跟踪主分支。
总结:写好 SKILL.md 并不需要复杂工程能力——它会自己从你的工作流中受益,你只需要一个公开仓库、一段诚实的描述和一行规范格式的条目。今晚装完、写好、提交 PR,你的技能可能明天就出现在 350+ 个 Hermes 技能之中。
