【Skills 系统从入门到精通】第 26 篇：官方技能与 skills.sh——官方仓库与 Vercel 目录

---

本篇你将学到

• Official Optional Skills 的定位和使用
• skills.sh（Vercel 技能目录）的搜索和安装
• 别名解析机制
• 上游更新检查与一键更新
• 实战操作完整流程

读完本篇，你将能够从最可靠的两个来源获取高质量技能。

---

一、Official Optional Skills

1.1 定位

官方可选技能是 Hermes 仓库中 optional-skills/ 目录下的技能。它们由 Hermes 团队维护，但不在安装时自动安装——用户按需选择。

1.2 信任等级：official

这些技能享有内置信任——安装时不显示第三方警告面板，不做社区级安全扫描。这是仅次于内置技能（builtin）的第二高信任级别。

1.3 浏览和安装

# 浏览所有官方可选技能
hermes skills browse --source official

# 搜索
hermes skills search security --source official

# 安装（格式：official/<分类>/<技能名>）
hermes skills install official/security/1password
hermes skills install official/migration/openclaw-migration

1.4 安装标识

官方技能的安装标识使用 official/ 前缀格式：

official/security/1password
official/migration/openclaw-migration
official/productivity/todoist

---

二、skills.sh 目录

2.1 定位

skills.sh 是 Vercel 运营的公共技能目录。它聚合了来自不同开发者和组织的技能，提供搜索和浏览功能。

2.2 信任等级：community

skills.sh 的技能信任等级为 community。安装时经过安全扫描，非危险项可以用 --force 覆盖。

2.3 搜索和安装

# 在 skills.sh 中搜索
hermes skills search react --source skills-sh

# 浏览
hermes skills browse --source skills-sh

# 预览
hermes skills inspect skills-sh/vercel-labs/json-render/json-render-react

# 安装
hermes skills install skills-sh/vercel-labs/json-render/json-render-react

# 如果扫描有非危险警告，加 --force 覆盖
hermes skills install skills-sh/vercel-labs/json-render/json-render-react --force

2.4 别名解析

skills.sh 上的技能 slug（URL 标识）可能和 GitHub 仓库目录名不一致。Hermes 会自动解析别名——你使用 skills.sh 上的 slug，Hermes 找到对应的 GitHub 仓库和正确目录。

2.5 上游更新

# 检查哪些 Hub 技能有上游变化
hermes skills check

# 更新所有有变化的技能
hermes skills update

# 只更新某个技能
hermes skills update react

更新机制使用存储的源标识加上上游内容 hash 来检测变化。

---

三、完整实战流程

3.1 场景：安装一个 Kubernetes 部署技能

# 步骤1：搜索
hermes skills search kubernetes
# 输出多个结果

# 步骤2：预览
hermes skills inspect openai/skills/k8s
# 查看技能详情、上游元数据、安全状态

# 步骤3：安装
hermes skills install openai/skills/k8s
# 安全扫描通过后安装

# 步骤4：验证
hermes skills list | grep k8s
# 确认已安装

# 步骤5：使用（新会话中）
hermes
/k8s deploy my-app to production namespace

---

本篇小结

来源	信任等级	安装标识	特点
official	official	official/<分类>/<名>	内置信任，无警告
skills-sh	community	skills-sh/<org>/<repo>/<名>	Vercel 目录，别名解析

---

下篇预告

下一篇讲解网站级技能发现——well-known 协议和直接 URL 安装。

---

如果本篇内容对你有帮助，欢迎点赞收藏！有任何疑问，欢迎在评论区交流。