词元之母TOK.MOM - 平台充值汇率 1:1 即 1 人民币充值到账 1 美元，支持一个 Key 调用近 600+ 海内外模型，限时特价模型低至 1 折，欢迎上岸！
"创建 Skill"
创建 Skill
应该创建 Skill 还是 Tool？
terminal 或 web_extract 调用的外部 CLI 或 APISkill 目录结构
skills/ 目录下，按类别组织。官方可选 skill 在 optional-skills/ 中使用相同结构：skills/
├── research/
│ └── arxiv/
│ ├── SKILL.md # 必需：主要指令
│ └── scripts/ # 可选：辅助脚本
│ └── search_arxiv.py
├── productivity/
│ └── ocr-and-documents/
│ ├── SKILL.md
│ ├── scripts/
│ └── references/
└── ...SKILL.md 格式
平台专属 Skill
platforms 字段将自身限制在 特定操作系统上：skills_list() 和斜杠命令中隐藏。若省略或留空，则在所有平台上加载（向后兼容）。条件式 Skill 激活
| 字段 | 行为 |
|---|---|
requires_toolsets | 当列出的任意 toolset 不可用时，skill 隐藏 |
requires_tools | 当列出的任意 tool 不可用时，skill 隐藏 |
fallback_for_toolsets | 当列出的任意 toolset 已可用时，skill 隐藏 |
fallback_for_tools | 当列出的任意 tool 已可用时，skill 隐藏 |
fallback_for_* 使用场景： 创建一个在主要 tool 不可用时作为替代方案的 skill。例如，带有 fallback_for_tools: [web_search] 的 duckduckgo-search skill 仅在未配置需要 API key 的 web search tool 时显示。requires_* 使用场景： 创建仅在 特定 tool 存在时才有意义的 skill。例如，带有 requires_toolsets: [web] 的网页抓取工作流 skill 在 web tool 被禁用时不会出现在 prompt 中。环境变量要求
skill_view 加载 skill 时，其所需变量会自动注册，以便透传（passthrough）到沙箱执行环境（terminal、execute_code）中。name（必需）——环境变量名称prompt（可选）——向用户询问值时的提示文本help（可选）——获取该值的帮助文本或 URLrequired_for（可选）——描述哪个功能需要此变量config.yaml 中手动配置透传变量：skills/apple/。加载时的安全配置
required_environment_variables。缺少值不会将 skill 从发现列表中隐藏。Hermes 会在本地 CLI 加载 skill 时安全地提示用户输入。沙箱透传
required_environment_variables 会自动透传到 execute_code 和 terminal 沙箱——包括 Docker 和 Modal 等远程后端。Skill 的脚本无需用户额外配置即可访问 $TENOR_API_KEY（或 Python 中的 os.environ["TENOR_API_KEY"]）。详见 环境变量透传。prerequisites.env_vars 作为向后兼容的别名仍受支持。Config 配置项（config.yaml）
config.yaml 的 skills.config 命名空间下。与环境变量（存储密钥）不同，config 配置项用于路径、偏好设置及其他非敏感值。key（必需）——配置项的点路径（例如 myplugin.path）description（必需）——说明该配置项的作用default（可选）——用户未配置时的默认值prompt（可选）——hermes config migrate 时显示的提示文本；若未设置则回退到 description1.
config.yaml 的 skills.config.<key> 下：2.
hermes config migrate 扫描所有已启用的 skill，找出未配置的项并提示用户。配置项也会在 hermes config show 的"Skill Settings"部分显示。3.
[Skill config (from ~/.hermes/config.yaml):
myplugin.path = /home/user/my-data
]config.yaml 即可看到已配置的值。4.
如何选择
required_environment_variables（存储在 ~/.hermes/.env，不向模型展示）。对路径、偏好设置及非敏感配置使用 config（存储在 config.yaml，在 config show 中可见）。凭证文件要求（OAuth token 等）
path（必需）——相对于 ~/.hermes/ 的文件路径description（可选）——说明该文件的用途及创建方式setup_needed。已存在的文件会自动：如何选择
~/.hermes/.env 中的字符串）使用 required_environment_variables。对 OAuth token 文件、客户端密钥、服务账号 JSON、证书或任何以磁盘文件形式存在的凭证使用 required_credential_files。skills/productivity/google-workspace/SKILL.md，其中同时使用了两者。Skill 规范
无外部依赖
web_extract、terminal、read_file）。若确实需要依赖 项，请在 skill 中记录安装步骤。渐进式披露
包含辅助脚本
scripts/ 中包含辅助脚本——不要每次都期望 LLM 内联编写解析器。以文档形式传递媒体（[[as_document]]）
[[as_document]]。Gateway 会去除该指令，并将该响应中所有提取的媒体路径以可下载文件附件的形式传递，而非内联图片气泡。完整语义请参见 Skill 输出与媒体传递。在 SKILL.md 中引用内置脚本
[Skill directory: /abs/path] 的形式暴露，同时在 SKILL.md 正文中替换两个模板 token：| Token | 替换为 |
|---|---|
${HERMES_SKILL_DIR} | skill 目录的绝对路径 |
${HERMES_SESSION_ID} | 当前会话 ID（若无会话则保留原样） |
terminal tool 执行已就绪的命令——无需路径计算，无需额外的 skill_view 往返。可在 config.yaml 中设置 skills.template_vars: false 全局禁用替换。内联 shell 片段（需手动开启）
!`cmd` 形式编写的内联 shell 片段。启用后，每个片段的 stdout 会在 agent 读取前内联到消息中，从而让 skill 注入动态上下文：[inline-shell error: ...] 标记，而不会导致整个 skill 中断。测试
Skill 应放在哪里？
skills/）随每次 Hermes 安装一起发布，应对大多数用户广泛有用：optional-skills/——它随仓库一起发布，可通过 hermes skills browse 发现（标记为"official"），并以内置信任级别安装。hermes skills install 分享。发布 Skill
发布到 Skills Hub
发布到自定义仓库
安全扫描
builtin——随 Hermes 一起发布（始终受信任）official——来自仓库中的 optional-skills/（内置信任，无第三方警告）trusted——来自 openai/skills、anthropics/skills、huggingface/skillscommunity——非危险发现可通过 --force 覆盖；dangerous 判定仍会被阻止openai/skills/k8s）skills.sh 标识符（例如 skills-sh/vercel-labs/json-render/json-render-react）/.well-known/skills/index.json 提供的 知名端点修改于 2026-05-31 00:25:01