Home
avatar

麒麟剑

上架 agentskills.io:把你的技能变成可分享、可售卖的资产

上架 agentskills.io:把你的技能变成可分享、可售卖的资产

你写了个超好用的 skill——自动填周报、批量处理发票、对接公司内部系统。它现在躺在你的 ~/.hermes/skills/ 里,只有你自己用。

可惜了。

Hermes 的技能遵循 agentskills.io 开放标准:一个 SKILL.md,结构公开、可移植、能被任何人装。这意味着你沉淀的流程,不只是一段提示词,而是可以分享、可以进市场、可以变成数字资产的产物。在本系列一直在聊的”AI 微型 SaaS / 可售卖数字资产”方向上,这是离钱最近的一步。

本章讲两件事:怎么发布/安装(命令),以及怎么把一个”自用玩具”包装成”别人开箱即用”的资产。

Skills Hub 是什么

Hermes 技能库:内置与自建技能、记忆及 MCP 统一管理 ▲ Hermes 技能库:内置与自建技能、记忆及 MCP 统一管理

agentskills.io 是开放的技能平台,不是某家的封闭商店。规范公开(agentskills.io/specification),任何人都可贡献。信任分四级:

级别含义安全处理
builtinHermes 内置默认可信
official官方维护(如 openai/skills)默认可信
trusted受信任来源默认可信
community社区贡献需安全扫描--force 可覆盖非危险策略阻止

装社区技能时如果策略拦了,先看清警告——--force 能盖掉”非危险”级别的阻止,但危险策略挡下的别硬盖

命令:订阅 / 安装 / 发布 / 浏览

# 订阅别人的 GitHub tap(技能源)
hermes skills tap add <owner/repo>

# 装单个技能
hermes skills install owner/repo/skills/my-workflow

# 发布你自己的技能到 GitHub
hermes skills publish skills/my-skill --to github --repo owner/repo

# 浏览官方技能
hermes skills browse --source official

发布本质是往你的 GitHub 仓库推一个符合规范的 skills/<name>/SKILL.md。所以”上架 agentskills.io”和”推到 GitHub”是同一件事——开放标准的好处就在这:没有平台抽成,仓库就是货架。

从”自用技能”到”可分享资产”:包装方法

很多人卡在”能跑就行”,结果别人装了跑不起来。一个对他人开箱即用的 skill,frontmatter 必须填满这几个字段(来自 SKILL.md 规范):

---
name: my-skill
description: Brief description of what this skill does   # ≤60 字符,必须直给
version: 1.0.0
platforms: [macos, linux]
metadata:
  hermes:
    tags: [python, automation]          # 让别人搜得到
    category: devops                    # 归类
    requires_toolsets: [terminal]       # 声明依赖,缺了会提示
    config:
      - key: my.setting
        description: "What this controls"
        default: "value"
        prompt: "Prompt for setup"
required_environment_variables:
  - TENOR_API_KEY                       # 缺了明确报错,而不是静默失败
---
# Skill Title
## When to Use
Trigger conditions for this skill.
## Procedure
1. Step one
2. Step two
## Pitfalls
- Known failure modes and fixes
## Verification
How to confirm it worked.

让 skill “对他人开箱即用”的几个硬标准:

  • description 写清”在什么情况下用”。代理靠它决定要不要触发你的技能。模糊的描述 = 永远不被调用。
  • tags + category 填准。这是别人在 browse 里发现你的入口。
  • requires_toolsets 声明依赖。你的技能要 terminal 就写 terminal,装的人环境缺了会立刻知道。
  • required_environment_variables 列全密钥。比如要调内部 API,把 TENOR_API_KEY 列出来,别人漏配会直接报错而不是诡异失败。
  • config 给出交互式 setup prompt。第一次用时 Hermes 会按 prompt 问用户要填什么,体验拉满。
  • 正文四段不能省:When to Use / Procedure / Pitfalls / Verification。尤其是 Pitfalls——你踩过的坑写进去,别人就不用来找你。

目录里还能放 references/templates/scripts/examples/assets/,按需加载(渐进式披露),别把大文件塞进 SKILL.md 正文。

⚠️ 避坑提示

  • 别把密钥写进技能正文。放 .env,frontmatter 用 required_environment_variables 声明。发出去的 skill 是公开的,硬编码 token 等于送人。
  • description 超 60 字符会被截断,且影响触发准确率,短而准。
  • community 技能先掂量安全扫描结果--force 是给你自己确认过的技能用的,不是给陌生仓库开绿灯。
  • 跨平台要测。你只在 macOS 跑通,就别把 platforms 写成 [macos, linux, windows] 骗人。写 [macos],诚实。
  • 版本号记得 bump。改了流程就升 version,用你技能的人靠它判断是否更新。

与”可售卖数字资产”的契合

这就是本系列一直在铺的暗线:你不是在写提示词,你是在生产可复用的数字劳动单元

  • 一个解决某垂直场景的 skill(比如”自动对账""小红书排版""法律合同初审”),发布到 agentskills.io,等于挂上了一个公开货架。
  • 开放标准 = 没有平台税、没有锁定,仓库即门店,GitHub Stars 即信用。
  • 结合第17章的企业集成能力,你甚至可以把”接某 SaaS 的技能”做成付费咨询 + 开源技能的组合拳。

从”用 AI”到”拥有 AI 资产”,agentskills.io 是把个人效率沉淀变成可分发产品的那道桥。

本节能造出什么数字员工

不算”造”新员工,而是给你的数字员工开个技能商店:既能把自家沉淀的技能标准化、发布出去变成资产,也能从官方/社区市场一键装回别人的好东西,让团队的数字员工能力像装 app 一样可拼装。

下篇预告

4 个案例(资讯官、新媒体官、研发助理、企业集成)都讲完了。最后一章第20章,我们把它们编成一支”虚拟公司”——用多 Profile + Bot Mode + 网关,搭出你的数字员工矩阵和商业闭环。


延伸阅读

Hermes Agent 数字员工 AI智能体 自托管 Nous Research agentskills.io 技能市场 数字资产 变现