TokenYep.COM -AI大模型中转站支持一个 Key 调用近 600+ 海内外模型,限时特价模型低至 1 折,欢迎上岸!
terminal 或 web_extract 调用的外部 CLI 或 APIskills/ 目录下,按类别组织。官方可选 skill 在 optional-skills/ 中使用相同结构:skills/
├── research/
│ └── arxiv/
│ ├── SKILL.md # 必需:主要指令
│ └── scripts/ # 可选:辅助脚本
│ └── search_arxiv.py
├── productivity/
│ └── ocr-and-documents/
│ ├── SKILL.md
│ ├── scripts/
│ └── references/
└── ...platforms 字段将自身限制在特定操作系统上:skills_list() 和斜杠命令中隐藏。若省略或留空,则在所有平台上加载(向后兼容)。| 字段 | 行为 |
|---|---|
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.yaml 的 skills.config 命名空间下。与环境变量(存储密钥)不同,config 配置项用于路径、偏好设置及其他非敏感值。key(必需)——配置项的点路径(例如 myplugin.path)description(必需)——说明该配置项的作用default(可选)——用户未配置时的默认值prompt(可选)——hermes config migrate 时显示的提示文本;若未设置则回退到 descriptionconfig.yaml 的 skills.config.<key> 下:hermes config migrate 扫描所有已启用的 skill,找出未配置的项并提示用户。配置项也会在 hermes config show 的"Skill Settings"部分显示。[Skill config (from ~/.hermes/config.yaml):
myplugin.path = /home/user/my-data
]config.yaml 即可看到已配置的值。required_environment_variables(存储在 ~/.hermes/.env,不向模型展示)。对路径、偏好设置及非敏感配置使用 config(存储在 config.yaml,在 config show 中可见)。path(必需)——相对于 ~/.hermes/ 的文件路径description(可选)——说明该文件的用途及创建方式setup_needed。已存在的文件会自动:~/.hermes/.env 中的字符串)使用 required_environment_variables。对 OAuth token 文件、客户端密钥、服务账号 JSON、证书或任何以磁盘文件形式存在的凭证使用 required_credential_files。skills/productivity/google-workspace/SKILL.md,其中同时使用了两者。web_extract、terminal、read_file)。若确实需要依赖项,请在 skill 中记录安装步骤。