Hermes Agent首次安装完成之后的目录结构大致如下:
Menlo, Operator Mono, Consolas, Monaco, monospace;">~/.hermes/
├── .env
├── config.yaml
├── SOUL.md
├── hermes-agent/
├── skills/
├── memories/
├── sessions/
├── logs/
└── ...其他运行目录
Hermes Agent会在安装过程中将全部源代码都拉入 /hermes-agent/ 目录中,运行环境及工作代码都在这个目录里;剩下的 /skills, /sessions/, memories/, SOUL.md等文件,熟悉OpenClaw的同学一看就笑了,这不就是OpenClaw的workspace么 没错,默认状态下,/.hermes/ 这个根目录就是Hermes Agent的workspace,等效于OpenClaw的 /.openclaw/workspace/ ;只有在多Agents情况下,Hermes才会多出一个 /.hermes/profiles/ 目录来作为其他agents的workspace。
Skills是Agent在需要时可以加载的知识和行动文档。它们遵循渐进式披露模式,以最小化令牌使用量,并且兼容 agentskills.io 开放标准(Claude Code、Codex等Coding Agent都使用的skills标准语法)。
所有技能都位于 ~/.hermes/skills/ —— 这是主目录和唯一可信源。在全新安装时,捆绑的技能会从代码仓库复制到此目录。从hub安装的以及代理创建的技能也会放在这里。代理可以修改或删除任何技能。
你也可以将 Hermes 指向外部技能目录——这些是除了本地目录外还会被扫描的额外文件夹。请参阅后面的外部技能目录。
每个已安装的技能都会自动作为一个斜杠命令可用:
# 在 CLI 或任何消息平台中:
/gif-search funny cats
/axolotl help me fine-tune Llama 3 on my dataset
/github-pr-workflow create a PR for the auth refactor
/plan design a rollout for migrating our auth provider
# 仅输入技能名称会加载它,并让代理询问你的需求:
/excalidraw
捆绑的 plan 技能是一个很好的例子,它是一个具有自定义行为的、由技能支持的斜杠命令。运行 /plan [请求] 会指示 Hermes 在需要时检查上下文,编写一个 Markdown 实施计划而不是执行任务,并将结果保存在相对于活动工作空间/后端工作目录的 .hermes/plans/ 下。
你也可以通过自然对话与技能交互:
hermes chat --toolsets skills -q "你有什么技能?"
hermes chat --toolsets skills -q "给我看看 axolotl 技能"
技能使用一种节省令牌的加载模式:
Level 0: skills_list() → [{name, description, category}, ...] (~3k tokens)
Level 1: skill_view(name) → 完整内容 + 元数据 (可变)
Level 2: skill_view(name, path) → 特定的参考文件 (可变)
代理只在真正需要时才加载完整的技能内容。
---
name: my-skill
description: 此技能功能的简要描述
version: 1.0.0
platforms: [macos, linux] # 可选——限制在特定的操作系统平台
metadata:
hermes:
tags: [python, automation]
category: devops
fallback_for_toolsets: [web] # 可选——条件激活(见下文)
requires_toolsets: [terminal] # 可选——条件激活(见下文)
---
# 技能标题
何时使用
此技能的触发条件。
步骤
1. 第一步
2. 第二步
常见问题
- 已知的失败模式及修复方法
验证
如何确认它已成功。
技能可以使用 platforms 字段限制自己只在特定的操作系统上运行:
macos
linux
windows
platforms: [macos] # 仅 macOS (例如,iMessage, Apple Reminders, FindMy)
platforms: [macos, linux] # macOS 和 Linux
当设置此字段时,技能会在不兼容的平台上自动从系统提示、skills_list() 和斜杠命令中隐藏。如果省略,技能将在所有平台上加载。
技能可以根据当前会话中可用的工具自动显示或隐藏自己。这对于备用技能最为有用——这些是免费或本地的替代方案,应该只在高级工具不可用时才出现。
metadata:
hermes:
fallback_for_toolsets: [web] # 仅当这些工具集不可用时显示
requires_toolsets: [terminal] # 仅当这些工具集可用时显示
fallback_for_tools: [web_search] # 仅当这些特定工具不可用时显示
requires_tools: [terminal] # 仅当这些特定工具可用时显示
fallback_for_toolsets
fallback_for_tools
requires_toolsets
requires_tools
示例: 内置的 duckduckgo-search 技能使用了 fallback_for_toolsets: [web]。当你设置了 FIRECRAWL_API_KEY 时,web 工具集可用,代理会使用 web_search —— DuckDuckGo 技能保持隐藏。如果 API 密钥缺失,web 工具集不可用,DuckDuckGo 技能会自动作为备用方案出现。
没有任何条件字段的技能行为与之前完全一样——它们总是显示。
技能可以声明所需的环境变量,而不会从发现列表中消失:
required_environment_variables:
- name: TENOR_API_KEY
prompt: Tenor API 密钥
help: 从 https://developers.google.com/tenor 获取密钥
required_for: 完整功能
当遇到缺失的值时,Hermes 仅在技能实际在本地 CLI 中加载时才会安全地询问。你可以跳过设置并继续使用该技能。消息界面永远不会在聊天中询问密钥——它们会告诉你在本地使用 hermes setup 或 ~/.hermes/.env。
一旦设置,声明的环境变量会自动传递到 execute_code 和 terminal 沙箱——技能的脚本可以直接使用 $TENOR_API_KEY。对于非技能的环境变量,请使用 terminal.env_passthrough 配置选项。详情请参阅环境变量传递。
~/.hermes/skills/ # 唯一可信源
├── mlops/ # 分类目录
│ ├── axolotl/
│ │ ├── SKILL.md # 主要说明(必需)
│ │ ├── references/ # 附加文档
│ │ ├── templates/ # 输出格式
│ │ ├── scripts/ # 可从技能调用的辅助脚本
│ │ └── assets/ # 补充文件
│ └── vllm/
│ └── SKILL.md
├── devops/
│ └── deploy-k8s/ # 代理创建的技能
│ ├── SKILL.md
│ └── references/
├── .hub/ # 技能中心状态
│ ├── lock.json
│ ├── quarantine/
│ └── audit.log
└── .bundled_manifest # 跟踪已植入的捆绑技能
如果你在 Hermes 之外维护技能——例如,一个被多个 AI 工具共享的 ~/.agents/skills/ 目录——你可以告诉 Hermes 也扫描这些目录。
在 ~/.hermes/config.yaml 的 skills 部分下添加 external_dirs:
skills:
external_dirs:
- ~/.agents/skills
- /home/shared/team-skills
- ${SKILLS_REPO}/skills
路径支持 ~ 扩展和 ${VAR} 环境变量替换。
-
• 只读 :外部目录仅用于技能发现扫描。当代理创建或编辑技能时,它总是写入
~/.hermes/skills/。 -
• 本地优先 :如果同一个技能名称同时存在于本地目录和外部目录中,则本地版本优先。
-
• 完全集成 :外部技能会出现在系统提示索引、
skills_list、skill_view以及/skill-name斜杠命令中——与本地技能没有区别。 -
• 不存在的路径会被静默跳过 :如果配置的目录不存在,Hermes 会忽略它而不报错。这对于可能并非每台机器上都存在的可选共享目录很有用。
~/.hermes/skills/ # 本地(主目录,读写)
├── devops/deploy-k8s/
│ └── SKILL.md
└── mlops/axolotl/
└── SKILL.md
~/.agents/skills/ # 外部(只读,共享)
├── my-custom-workflow/
│ └── SKILL.md
└── team-conventions/
└── SKILL.md
所有四个技能都会出现在你的技能索引中。如果你在本地创建一个名为 my-custom-workflow 的新技能,它会覆盖外部版本。
Agent可以通过 skill_manage 工具创建、更新和删除自己的技能。这是代理的程序性记忆(Procedural Memory)——当它弄清楚一个非平凡的工作流程时,它会将该方法保存为一个技能以供将来重用。
create
name
content
(完整的 SKILL.md),可选的
category
patch
name
old_string
,
new_string
edit
name
content
(完整的 SKILL.md 替换)
delete
name
write_file
name
file_path
,
file_content
remove_file
name
file_path
Tip
patch操作是推荐的更新方式——它比edit更节省令牌,因为只有更改的文本会出现在工具调用中。
从官方official、skills.sh、直接已知技能端点以及官方可选技能中浏览、搜索、安装和管理技能。
hermes skills browse # 浏览所有中心技能(官方优先)
hermes skills browse --source official # 仅浏览官方可选技能
hermes skills search kubernetes # 搜索所有来源
hermes skills search react --source skills-sh # 搜索 skills.sh 目录
hermes skills search https://mintlify.com/docs --source well-known
hermes skills inspect openai/skills/k8s # 安装前预览
hermes skills install openai/skills/k8s # 安装并进行安全扫描
hermes skills install official/security/1password
hermes skills install skills-sh/vercel-labs/json-render/json-render-react --force
hermes skills install well-known:https://mintlify.com/docs/.well-known/skills/mintlify
hermes skills list --source hub # 列出从中心安装的技能
hermes skills check # 检查已安装的中心技能是否有上游更新
hermes skills update # 在需要时重新安装有上游更改的中心技能
hermes skills audit # 重新扫描所有中心技能的安全性
hermes skills uninstall k8s # 移除一个中心技能
hermes skills publish skills/my-skill --to github --repo owner/repo
hermes skills snapshot export setup.json # 导出技能配置
hermes skills tap add myorg/skills-repo # 添加自定义 GitHub 源
official
official/security/1password
skills-sh
skills-sh/vercel-labs/agent-skills/vercel-react-best-practices
hermes skills search
–source skills-sh
搜索。当 skills.sh 的别名与仓库文件夹不同时,Hermes 会解析别名风格的技能。
well-known
well-known:https://mintlify.com/docs/.well-known/skills/mintlify
/.well-known/skills/index.json
提供的技能。使用网站或文档 URL 进行搜索。
github
openai/skills/k8s
clawhub
lobehub
,
claude-marketplace
Hermes 目前集成了以下技能生态系统和发现来源:
1. 官方可选技能 (official)
这些技能在 Hermes 仓库内部维护,安装时自带信任度。
-
• 目录:官方可选技能目录
-
• 仓库内源位置:
optional-skills/ -
• 示例:
Menlo, Operator Mono, Consolas, Monaco, monospace;">hermes skills browse --source official
hermes skills install official/security/1password
2. skills.sh (skills-sh)
这是 Vercel 的公共技能目录。Hermes 可以直接搜索它,查看技能详情页面,解析别名形式的短名称,并从底层的源码仓库安装。
hermes skills search react --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
3. 知名技能端点 (well-known)
这是基于 URL 的发现方式,从发布 /.well-known/skills/index.json 的网站获取。它不是单一的中心化枢纽,而是网络发现约定。
hermes skills search https://mintlify.com/docs --source well-known
hermes skills inspect well-known:https://mintlify.com/docs/.well-known/skills/mintlify
hermes skills install well-known:https://mintlify.com/docs/.well-known/skills/mintlify
4. 直接 GitHub 技能 (github)
Hermes 可以直接从 GitHub 仓库和基于 GitHub 的 taps 安装。当你已经知道仓库/路径或者想添加自己的自定义源仓库时,这很有用。
默认 taps(无需设置即可浏览):
hermes skills install openai/skills/k8s
hermes skills tap add myorg/skills-repo
5. ClawHub (clawhub)
一个作为社区源集成的第三方技能市场。
-
• 站点:clawhub.ai
-
• Hermes 源标识:
clawhub
6. Claude 市场风格仓库 (claude-marketplace)
Hermes 支持发布 Claude 兼容的插件/市场清单的市场仓库。
已知的集成源包括:
Hermes 源标识:claude-marketplace
7. LobeHub (lobehub)
Hermes 可以从 LobeHub 的公共目录中搜索并转换智能体条目为可安装的 Hermes 技能。
-
• 站点:LobeHub
-
• 公共智能体索引:chat-agents.lobehub.com
-
• 支撑仓库:lobehub/lobe-chat-agents
-
• Hermes 源标识:
lobehub
所有通过 hub 安装的技能都会经过一个安全扫描器的检查,它会检测数据窃取、提示注入、破坏性命令、供应链信号和其他威胁。
hermes skills inspect ... 现在也会在有可用信息时展示上游元数据:
当你已经审查了一个第三方技能并想覆盖一个非危险的政策阻止时,请使用 --force:
hermes skills install skills-sh/anthropics/skills/pdf --force
重要行为:
-
•
--force可以覆盖针对谨慎/警告类发现的政策阻止。 -
•
--force不会 覆盖dangerous扫描裁决。 -
• 官方可选技能 (
official/...) 被视为自带信任,不会显示第三方警告面板。
builtin
official
optional-skills/
trusted
openai/skills
,
anthropics/skills
community
skills.sh
, 知名端点, 自定义 GitHub 仓库, 大多数市场)
--force
覆盖;
dangerous
裁决保持阻止
hub 现在会追踪足够的来源信息,以重新检查已安装技能的在线副本:
hermes skills check # 报告哪些已安装的 hub 技能在上游发生了变化
hermes skills update # 仅重新安装有可用更新的技能
hermes skills update react # 更新一个特定的已安装 hub 技能
这使用了存储的源标识加上当前上游 bundle 内容哈希来检测变更。
所有相同的命令都可以通过 /skills 使用:
/skills browse
/skills search react --source skills-sh
/skills search https://mintlify.com/docs --source well-known
/skills inspect skills-sh/vercel-labs/json-render/json-render-react
/skills install openai/skills/skill-creator --force
/skills check
/skills update
/skills list
官方可选技能仍然使用像
official/security/1password和official/migration/openclaw-migration这样的标识符。
Hermes 附带一个庞大的内置技能库,安装时会复制到 ~/.hermes/skills/ 目录下。本页面记录了位于仓库 skills/ 目录下的内置技能。
Apple/macOS 专属技能 —— iMessage、提醒事项、备忘录、查找以及 macOS 自动化。这些技能仅在 macOS 系统上加载。
apple-notes
apple/apple-notes
apple-reminders
apple/apple-reminders
findmy
apple/findmy
imessage
apple/imessage
用于启动和编排自主 AI 编程智能体及多智能体工作流的技能 —— 运行独立的智能体进程、委派任务、协调并行工作流。
claude-code
autonomous-ai-agents/claude-code
codex
autonomous-ai-agents/codex
hermes-agent-spawning
autonomous-ai-agents/hermes-agent
opencode
autonomous-ai-agents/opencode
用于数据科学工作流的技能 —— 交互式探索、Jupyter 笔记本、数据分析和可视化。
jupyter-live-kernel
data-science/jupyter-live-kernel
创意内容生成 —— ASCII 艺术、手绘风格图表和视觉设计工具。
ascii-art
creative/ascii-art
ascii-video
creative/ascii-video
excalidraw
creative/excalidraw
DevOps 和基础设施自动化技能。
webhook-subscriptions
devops/webhook-subscriptions
dogfood
dogfood/dogfood
hermes-agent-setup
dogfood/hermes-agent-setup
用于从终端发送、接收、搜索和管理电子邮件的技能。
himalaya
email/himalaya
用于设置、配置和管理游戏服务器、模组包及游戏相关基础设施的技能。
minecraft-modpack-server
gaming/minecraft-modpack-server
pokemon-player
gaming/pokemon-player
使用 gh CLI 和 git 通过终端管理仓库、拉取请求、代码审查、问题和 CI/CD 管道的 GitHub 工作流技能。
codebase-inspection
github/codebase-inspection
github-auth
github/github-auth
github-code-review
github/github-code-review
github-issues
github/github-issues
github-pr-workflow
github/github-pr-workflow
github-repo-management
github/github-repo-management
通过 inference.sh 云平台执行 AI 应用的技能。
inference-sh-cli
inference-sh/cli
find-nearby
leisure/find-nearby
用于处理 MCP(模型上下文协议)服务器、工具和集成的技能。包括内置的原生 MCP 客户端(在 config.yaml 中配置服务器以自动发现工具)以及用于临时服务器交互的 mcporter CLI 桥接。
mcporter
mcp/mcporter
native-mcp
mcp/native-mcp
用于处理媒体内容的技能 —— YouTube 字幕、GIF 搜索、音乐生成和音频可视化。
gif-search
media/gif-search
heartmula
media/heartmula
songsee
media/songsee
youtube-content
media/youtube-content
通用 ML 运维工具 —— 模型中心管理、数据集操作和工作流编排。
huggingface-hub
mlops/huggingface-hub
用于 ML 工作负载的 GPU 云提供商和无服务器计算平台。
lambda-labs-gpu-cloud
mlops/cloud/lambda-labs
modal-serverless-gpu
mlops/cloud/modal
模型评估基准、实验跟踪、数据整理、分词器和可解释性工具。
evaluating-llms-harness
mlops/evaluation/lm-evaluation-harness
huggingface-tokenizers
mlops/evaluation/huggingface-tokenizers
nemo-curator
mlops/evaluation/nemo-curator
sparse-autoencoder-training
mlops/evaluation/saelens
weights-and-biases
mlops/evaluation/weights-and-biases
模型服务、量化(GGUF/GPTQ)、结构化输出、推理优化和模型手术工具,用于部署和运行 LLM。
gguf-quantization
mlops/inference/gguf
guidance
mlops/inference/guidance
instructor
mlops/inference/instructor
llama-cpp
mlops/inference/llama-cpp
obliteratus
mlops/inference/obliteratus
outlines
mlops/inference/outlines
serving-llms-vllm
mlops/inference/vllm
tensorrt-llm
mlops/inference/tensorrt-llm
特定模型架构和工具——计算机视觉(CLIP、SAM、Stable Diffusion)、语音(Whisper)、音频生成(AudioCraft)和多模态模型(LLaVA)。
audiocraft-audio-generation
mlops/models/audiocraft
clip
mlops/models/clip
llava
mlops/models/llava
segment-anything-model
mlops/models/segment-anything
stable-diffusion-image-generation
mlops/models/stable-diffusion
whisper
mlops/models/whisper
用于通过声明式编程构建和优化 AI 系统的 ML 研究框架。
dspy
mlops/research/dspy
用于训练 LLM 和其他模型的微调、RLHF/DPO/GRPO 训练、分布式训练框架和优化工具。
axolotl
mlops/training/axolotl
distributed-llm-pretraining-torchtitan
mlops/training/torchtitan
fine-tuning-with-trl
mlops/training/trl-fine-tuning
grpo-rl-training
mlops/training/grpo-rl-training
hermes 阿特洛波斯环境
mlops/training/hermes-atropos-environments
huggingface-accelerate
mlops/training/accelerate
optimizing-attention-flash
mlops/training/flash-attention
peft-fine-tuning
mlops/training/peft
pytorch-fsdp
mlops/training/pytorch-fsdp
pytorch-lightning
mlops/training/pytorch-lightning
simpo-training
mlops/training/simpo
slime-rl-training
mlops/training/slime
unsloth
mlops/training/unsloth
用于 RAG、语义搜索和 AI 应用后端的向量相似性搜索和嵌入数据库。
chroma
mlops/vector-databases/chroma
faiss
mlops/vector-databases/faiss
pinecone
mlops/vector-databases/pinecone
qdrant-vector-search
mlops/vector-databases/qdrant
笔记技能,用于保存信息、协助研究,以及在多会话规划和信息共享上进行协作。
obsidian
note-taking/obsidian
用于文档创建、演示文稿、电子表格和其他生产力工作流的技能。
google-workspace
productivity/google-workspace
linear
productivity/linear
nano-pdf
productivity/nano-pdf
notion
productivity/notion
ocr-and-documents
productivity/ocr-and-documents
powerpoint
productivity/powerpoint
用于学术研究、论文发现、文献综述、领域侦察、市场数据、内容监控和科学知识检索的技能。
arxiv
research/arxiv
blogwatcher
research/blogwatcher
domain-intel
research/domain-intel
duckduckgo-search
ddgs
CLI;仅在确认当前运行时环境中
ddgs
可用时,才使用 Python DDGS 库。
research/duckduckgo-search
ml-paper-writing
research/ml-paper-writing
polymarket
research/polymarket
用于 LLM 红队测试、越狱和安全过滤器绕过研究的技能。
godmode
red-teaming/godmode
用于控制智能家居设备(灯光、开关、传感器和家庭自动化系统)的技能。
openhue
smart-home/openhue
用于与社交平台交互的技能——发布、阅读、监控和账户操作。
xitter
social-media/xitter
code-review
software-development/code-review
plan
.hermes/plans/
中,但不执行具体工作。
software-development/plan
requesting-code-review
software-development/requesting-code-review
subagent-driven-development
software-development/subagent-driven-development
systematic-debugging
software-development/systematic-debugging
test-driven-development
software-development/test-driven-development
writing-plans
software-development/writing-plans
可选技能随仓库提供,位于 optional-skills/ 目录下,但默认不激活。它们涵盖较重或小众的用例。使用以下命令安装:
hermes skills install official/
/
blackbox
autonomous-ai-agents/blackbox
base
blockchain/base
solana
blockchain/solana
blender-mcp
creative/blender-mcp
meme-generation
creative/meme-generation
docker-management
devops/docker-management
agentmail
email/agentmail
neuroskill-bci
health/neuroskill-bci
fastmcp
mcp/fastmcp
openclaw-migration
migration/openclaw-migration
telephony
productivity/telephony
bioinformatics
research/bioinformatics
qmd
research/qmd
1password
security/1password
oss-forensics
security/oss-forensics
sherlock
security/sherlock
官方可选技能位于仓库的 optional-skills/ 目录下。使用 hermes skills install official/
命令安装,或使用 hermes skills browse –source official 命令浏览。
blackbox
autonomous-ai-agents/blackbox
base
blockchain/base
solana
blockchain/solana
blender-mcp
creative/blender-mcp
meme-generation
creative/meme-generation
agentmail
email/agentmail
neuroskill-bci
health/neuroskill-bci
fastmcp
mcp/fastmcp
openclaw-migration
migration/openclaw-migration
telephony
productivity/telephony
bioinformatics
research/bioinformatics
qmd
research/qmd
1password
security/1password
oss-forensics
security/oss-forensics
sherlock
security/sherlock
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/264591.html