awesome-hermes-skills技能开发教程:如何编写并发布你的第一个SKILL.md

原创2026-11-06 13:20:402,245 阅读

awesome-hermes-skills技能开发教程:如何编写并发布你的第一个SKILL.md

awesome-hermes-skills 是 Nous Research 旗下 Hermes Agent 生态的精选技能目录,收录了 350+ 个 Hermes 技能、插件与记忆后端。本教程带你用 5 步完成从零到上架的完整流程:安装 Hermes 技能、理解 SKILL.md 结构、编写你的第一个技能文件,最终把成果提交进 awesome-hermes-skills 目录。

awesome-hermes-skills Hermes技能目录与SKILL.md技能清单项目横幅

一、先认识项目: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,核心是"四条全满足才合并":

  1. ✅ 链接可解析(公开、不是 404)
  2. ✅ 背后有真东西(真实 SKILL.md + README)
  3. ✅ 在被维护(近 6 个月有提交)
  4. ✅ 目录里还没有(先搜过)

而拒绝只有四种理由:死链、无实质内容、垃圾信息、重复——而且维护者会明确告诉你中了哪条,改好随时欢迎回来。

给新人的定心丸:📌 格式错误不会让 PR 被拒。放错字母序、标签没加粗、破折号打错,维护者会顺手修好再合并。别让一个逗号挡住你提交 PR。

六、进阶:从 Skill 到跨平台插件

如果你的技能想走出 Hermes,可以了解一下 README.md 中"Skills → Plugins"一节介绍的 Agent Plugins 开放标准:插件就是一个目录,包含 plugin.json、skills/<技能名>/SKILL.md 等文件。已经写好 SKILL.md 的你,其实已经完成了一大半——同一个技能可以原样放进插件,在更多智能体运行环境中加载。

七、相关文件与安全提醒

📁 项目内的关键文件,都给了相对路径方便你直接查看:

⚠️ 最后一条安全须知(同样写在 README.md 中):目录里的技能是精选过的,但不是审计过的。技能会以安装者的权限运行,安装前请读源码;生产环境建议锁定到具体提交而非跟踪主分支。

总结:写好 SKILL.md 并不需要复杂工程能力——它会自己从你的工作流中受益,你只需要一个公开仓库、一段诚实的描述和一行规范格式的条目。今晚装完、写好、提交 PR,你的技能可能明天就出现在 350+ 个 Hermes 技能之中。

登录后查看全文
awesome-hermes-skills