AGENT SKILL
hermes-ecosystem-installation
暂无简介
- License 许可
- Apache-2.0
- 最近更新
- 2026-10-24
- Stars
- ★ 0
- Forks
- 0
02 资源文件 1
- 参考文档skill.json385 B
03 SKILL.md 正文
hermes-ecosystem-installation
Hermes Ecosystem Installation
Installing community skills/plugins (GitHub repos, awesome-hermes-agent, agentskills.io, skill registries). Verified 2026-08-10 on a bulk 6-item install.
Skills (bulk pattern)
- Clone:
git clone --depth 1 -q <repo> /tmp/dir - Skills live in varied paths (
/SKILL.md,skills/*/SKILL.md,.claude/skills/*/SKILL.md,writing-skills/*/). Walk the tree for dirs containingSKILL.md, copy each dir into~/.hermes/skills/<category>/<name>/(name from frontmattername:, fallback = dir name). - Collision dedup: big packs (e.g. dev-gtm) bundle their own copies of superpowers skills (
brainstorming,test-driven-development,using-superpowers) — REMOVE the duplicates from the new category, never overwrite the canonical ones. Checkhermes skills listafter. - Skip the repo's non-skill dirs (
.git,scripts,tools,schema,assets). - Verify:
hermes skills check(audit/updates) +hermes skills listtail (counts: "N enabled").
Plugins
hermes plugins install <owner/repo>copies the repo; portable packages install DISABLED — enable after.- Manifest-less plugins (no
plugin.yaml/plugin.jsonat root):hermes plugins installcopies the repo but the loader can't see it. Ifpyproject.tomlhas[project.entry-points."hermes_agent.plugins"] name = "module", install the package into the hermes venv:/home/hermes/.hermes/hermes-agent/venv/bin/pip install <plugin-dir>— it then appears asentrypointsource, enabled by the ENTRY-POINT name (e.g. repo rtk-hermes → plugin idrtk-rewrite), not the repo name. - Tool-override permission: enabling a plugin that can intercept tools prompts "Grant it?" — declining is fine for normal operation (
hermes plugins enable <name>succeeds;--allow-tool-overridegrants the privileged path later if needed). Default: enable without override. - Gateway restart is required for plugins to take effect and is BLOCKED from inside the gateway process ("cannot restart the gateway from inside the gateway process"). Tell the user to run
hermes gateway restartfrom a separate shell, or it activates on the next natural restart. Don't attempt it in-session.
Pitfalls
hermes mcp add— flags after--argsleak into the TOOL's argv, not Hermes'.hermes mcp add headroom --command /path/bin --args mcp serve --connect-timeout 90passes--connect-timeout 90to the tool itself → it errors at startup → "✗ Connection failed: Connection closed". Fix: keep--argspure tool args (--args mcp serve) and pipeprintf 'Y\n' |into the command so the interactive "Enable all N tools? [Y/n]" prompt resolves in non-tty sessions. Verify withhermes mcp test <name>; new MCP tools load next session.- Cron prompts must never embed secrets or curl-with-token — a prompt containing
curl .../bot${TELEGRAM_BOT_TOKEN}/getChatis BLOCKED by theexfil_curl_urlthreat pattern at job creation. Wrap the call in a local script (e.g.~/.hermes/scripts/cc_subs.pyreads the token from~/.hermes/.envitself, prints a result) and have the cron prompt invoke the script. Script-indirection is the sanctioned pattern for cron jobs needing secrets/metrics. hermes skills install <identifier>takes a registry identifier or SKILL.md URL — for local dirs, manual copy (above) is more predictable.- The awesome-hermes-agent list tags items
production/beta/experimental— beta+ items usually install cleanly; experimental ones may lack manifests. - After bulk installs, re-run
hermes skills check— a clean audit is the completion signal.