mirror of https://github.com/NousResearch/hermes-agent.git synced 2026-05-18 04:41:56 +00:00

docs: deep audit — fix stale config keys, missing commands, and registry drift (#22784 )

* docs: deep audit — fix stale config keys, missing commands, and registry drift

Cross-checked ~80 high-impact docs pages (getting-started, reference, top-level
user-guide, user-guide/features) against the live registries:

  hermes_cli/commands.py    COMMAND_REGISTRY (slash commands)
  hermes_cli/auth.py        PROVIDER_REGISTRY (providers)
  hermes_cli/config.py      DEFAULT_CONFIG (config keys)
  toolsets.py               TOOLSETS (toolsets)
  tools/registry.py         get_all_tool_names() (tools)
  python -m hermes_cli.main <subcmd> --help (CLI args)

reference/
- cli-commands.md: drop duplicate hermes fallback row + duplicate section,
  add stepfun/lmstudio to --provider enum, expand auth/mcp/curator subcommand
  lists to match --help output (status/logout/spotify, login, archive/prune/
  list-archived).
- slash-commands.md: add missing /sessions and /reload-skills entries +
  correct the cross-platform Notes line.
- tools-reference.md: drop bogus '68 tools' headline, drop fictional
  'browser-cdp toolset' (these tools live in 'browser' and are runtime-gated),
  add missing 'kanban' and 'video' toolset sections, fix MCP example to use
  the real mcp_<server>_<tool> prefix.
- toolsets-reference.md: list browser_cdp/browser_dialog inside the 'browser'
  row, add missing 'kanban' and 'video' toolset rows, drop the stale
  '38 tools' count for hermes-cli.
- profile-commands.md: add missing install/update/info subcommands, document
  fish completion.
- environment-variables.md: dedupe GMI_API_KEY/GMI_BASE_URL rows (kept the
  one with the correct gmi-serving.com default).
- faq.md: Anthropic/Google/OpenAI examples — direct providers exist (not just
  via OpenRouter), refresh the OpenAI model list.

getting-started/
- installation.md: PortableGit (not MinGit) is what the Windows installer
  fetches; document the 32-bit MinGit fallback.
- installation.md / termux.md: installer prefers .[termux-all] then falls
  back to .[termux].
- nix-setup.md: Python 3.12 (not 3.11), Node.js 22 (not 20); fix invalid
  'nix flake update --flake' invocation.
- updating.md: 'hermes backup restore --state pre-update' doesn't exist —
  point at the snapshot/quick-snapshot flow; correct config key
  'updates.pre_update_backup' (was 'update.backup').

user-guide/
- configuration.md: api_max_retries default 3 (not 2); display.runtime_footer
  is the real key (not display.runtime_metadata_footer); checkpoints defaults
  enabled=false / max_snapshots=20 (not true / 50).
- configuring-models.md: 'hermes model list' / 'hermes model set ...' don't
  exist — hermes model is interactive only.
- tui.md: busy_indicator -> tui_status_indicator with values
  kaomoji|emoji|unicode|ascii (not kawaii|minimal|dots|wings|none).
- security.md: SSH backend keys (TERMINAL_SSH_HOST/USER/KEY) live in .env,
  not config.yaml.
- windows-wsl-quickstart.md: there is no 'hermes api' subcommand — the
  OpenAI-compatible API server runs inside hermes gateway.

user-guide/features/
- computer-use.md: approvals.mode (not security.approval_level); fix broken
  ./browser-use.md link to ./browser.md.
- fallback-providers.md: top-level fallback_providers (not
  model.fallback_providers); the picker is subcommand-based, not modal.
- api-server.md: API_SERVER_* are env vars — write to per-profile .env,
  not 'hermes config set' which targets YAML.
- web-search.md: drop web_crawl as a registered tool (it isn't); deep-crawl
  modes are exposed through web_extract.
- kanban.md: failure_limit default is 2, not '~5'.
- plugins.md: drop hard-coded '33 providers' count.
- honcho.md: fix unclosed quote in echo HONCHO_API_KEY snippet; document
  that 'hermes honcho' subcommand is gated on memory.provider=honcho;
  reconcile subcommand list with actual --help output.
- memory-providers.md: legacy 'hermes honcho setup' redirect documented.

Verified via 'npm run build' — site builds cleanly; broken-link count went
from 149 to 146 (no regressions, fixed a few in passing).

* docs: round 2 audit fixes + regenerate skill catalogs

Follow-up to the previous commit on this branch:

Round 2 manual fixes:
- quickstart.md: KIMI_CODING_API_KEY mentioned alongside KIMI_API_KEY;
  voice-mode and ACP install commands rewritten — bare 'pip install ...'
  doesn't work for curl-installed setups (no pip on PATH, not in repo
  dir); replaced with 'cd ~/.hermes/hermes-agent && uv pip install -e
  ".[voice]"'. ACP already ships in [all] so the curl install includes it.
- cli.md / configuration.md: 'auxiliary.compression.model' shown as
  'google/gemini-3-flash-preview' (the doc's own claimed default);
  actual default is empty (= use main model). Reworded as 'leave empty
  (default) or pin a cheap model'.
- built-in-plugins.md: added the bundled 'kanban/dashboard' plugin row
  that was missing from the table.

Regenerated skill catalogs:
- ran website/scripts/generate-skill-docs.py to refresh all 163 per-skill
  pages and both reference catalogs (skills-catalog.md,
  optional-skills-catalog.md). This adds the entries that were genuinely
  missing — productivity/teams-meeting-pipeline (bundled),
  optional/finance/* (entire category — 7 skills:
  3-statement-model, comps-analysis, dcf-model, excel-author, lbo-model,
  merger-model, pptx-author), creative/hyperframes,
  creative/kanban-video-orchestrator, devops/watchers,
  productivity/shop-app, research/searxng-search,
  apple/macos-computer-use — and rewrites every other per-skill page from
  the current SKILL.md. Most diffs are tiny (one line of refreshed
  metadata).

Validation:
- 'npm run build' succeeded.
- Broken-link count moved 146 -> 155 — the +9 are zh-Hans translation
  shells that lag every newly-added skill page (pre-existing pattern).
  No regressions on any en/ page.

2026-05-09 13:19:51 -07:00

19 KiB

Raw Blame History

sidebar_position	title	description
5	Bundled Skills Catalog	Catalog of bundled skills that ship with Hermes Agent

Bundled Skills Catalog

Hermes ships with a large built-in skill library copied into ~/.hermes/skills/ on install. Each skill below links to a dedicated page with its full definition, setup, and usage.

Hermes also syncs bundled skills on hermes update, but the sync manifest respects local deletions and user edits. If a skill listed here is missing from your profile's ~/.hermes/skills/ tree, it is still shipped with Hermes; restore it with hermes skills reset <name> --restore.

If a skill is missing from this list but present in the repo, the catalog is regenerated by website/scripts/generate-skill-docs.py.

apple

Skill	Description	Path
`apple-notes`	Manage Apple Notes via memo CLI: create, search, edit.	`apple/apple-notes`
`apple-reminders`	Apple Reminders via remindctl: add, list, complete.	`apple/apple-reminders`
`findmy`	Track Apple devices/AirTags via FindMy.app on macOS.	`apple/findmy`
`imessage`	Send and receive iMessages/SMS via the imsg CLI on macOS.	`apple/imessage`
`macos-computer-use`	Drive the macOS desktop in the background — screenshots, mouse, keyboard, scroll, drag — without stealing the user's cursor, keyboard focus, or Space. Works with any tool-capable model. Load this skill whenever the `computer_use` tool is...	`apple/macos-computer-use`

autonomous-ai-agents

Skill	Description	Path
`claude-code`	Delegate coding to Claude Code CLI (features, PRs).	`autonomous-ai-agents/claude-code`
`codex`	Delegate coding to OpenAI Codex CLI (features, PRs).	`autonomous-ai-agents/codex`
`hermes-agent`	Configure, extend, or contribute to Hermes Agent.	`autonomous-ai-agents/hermes-agent`
`opencode`	Delegate coding to OpenCode CLI (features, PR review).	`autonomous-ai-agents/opencode`

creative

Skill	Description	Path
`architecture-diagram`	Dark-themed SVG architecture/cloud/infra diagrams as HTML.	`creative/architecture-diagram`
`ascii-art`	ASCII art: pyfiglet, cowsay, boxes, image-to-ascii.	`creative/ascii-art`
`ascii-video`	ASCII video: convert video/audio to colored ASCII MP4/GIF.	`creative/ascii-video`
`baoyu-comic`	Knowledge comics (知识漫画): educational, biography, tutorial.	`creative/baoyu-comic`
`baoyu-infographic`	Infographics: 21 layouts x 21 styles (信息图, 可视化).	`creative/baoyu-infographic`
`claude-design`	Design one-off HTML artifacts (landing, deck, prototype).	`creative/claude-design`
`comfyui`	Generate images, video, and audio with ComfyUI — install, launch, manage nodes/models, run workflows with parameter injection. Uses the official comfy-cli for lifecycle and direct REST/WebSocket API for execution.	`creative/comfyui`
`ideation`	Generate project ideas via creative constraints.	`creative/creative-ideation`
`design-md`	Author/validate/export Google's DESIGN.md token spec files.	`creative/design-md`
`excalidraw`	Hand-drawn Excalidraw JSON diagrams (arch, flow, seq).	`creative/excalidraw`
`humanizer`	Humanize text: strip AI-isms and add real voice.	`creative/humanizer`
`manim-video`	Manim CE animations: 3Blue1Brown math/algo videos.	`creative/manim-video`
`p5js`	p5.js sketches: gen art, shaders, interactive, 3D.	`creative/p5js`
`pixel-art`	Pixel art w/ era palettes (NES, Game Boy, PICO-8).	`creative/pixel-art`
`popular-web-designs`	54 real design systems (Stripe, Linear, Vercel) as HTML/CSS.	`creative/popular-web-designs`
`pretext`	Use when building creative browser demos with @chenglou/pretext — DOM-free text layout for ASCII art, typographic flow around obstacles, text-as-geometry games, kinetic typography, and text-powered generative art. Produces single-file HT...	`creative/pretext`
`sketch`	Throwaway HTML mockups: 2-3 design variants to compare.	`creative/sketch`
`songwriting-and-ai-music`	Songwriting craft and Suno AI music prompts.	`creative/songwriting-and-ai-music`
`touchdesigner-mcp`	Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.	`creative/touchdesigner-mcp`

data-science

Skill	Description	Path
`jupyter-live-kernel`	Iterative Python via live Jupyter kernel (hamelnb).	`data-science/jupyter-live-kernel`

devops

Skill	Description	Path
`kanban-orchestrator`	Decomposition playbook + specialist-roster conventions + anti-temptation rules for an orchestrator profile routing work through Kanban. The "don't do the work yourself" rule and the basic lifecycle are auto-injected into every kanban wor...	`devops/kanban-orchestrator`
`kanban-worker`	Pitfalls, examples, and edge cases for Hermes Kanban workers. The lifecycle itself is auto-injected into every worker's system prompt as KANBAN_GUIDANCE (from agent/prompt_builder.py); this skill is what you load when you want deeper det...	`devops/kanban-worker`
`webhook-subscriptions`	Webhook subscriptions: event-driven agent runs.	`devops/webhook-subscriptions`

dogfood

Skill	Description	Path
`dogfood`	Exploratory QA of web apps: find bugs, evidence, reports.	`dogfood`

email

Skill	Description	Path
`himalaya`	Himalaya CLI: IMAP/SMTP email from terminal.	`email/himalaya`

gaming

Skill	Description	Path
`minecraft-modpack-server`	Host modded Minecraft servers (CurseForge, Modrinth).	`gaming/minecraft-modpack-server`
`pokemon-player`	Play Pokemon via headless emulator + RAM reads.	`gaming/pokemon-player`

github

Skill	Description	Path
`codebase-inspection`	Inspect codebases w/ pygount: LOC, languages, ratios.	`github/codebase-inspection`
`github-auth`	GitHub auth setup: HTTPS tokens, SSH keys, gh CLI login.	`github/github-auth`
`github-code-review`	Review PRs: diffs, inline comments via gh or REST.	`github/github-code-review`
`github-issues`	Create, triage, label, assign GitHub issues via gh or REST.	`github/github-issues`
`github-pr-workflow`	GitHub PR lifecycle: branch, commit, open, CI, merge.	`github/github-pr-workflow`
`github-repo-management`	Clone/create/fork repos; manage remotes, releases.	`github/github-repo-management`

mcp

Skill	Description	Path
`native-mcp`	MCP client: connect servers, register tools (stdio/HTTP).	`mcp/native-mcp`

media

Skill	Description	Path
`gif-search`	Search/download GIFs from Tenor via curl + jq.	`media/gif-search`
`heartmula`	HeartMuLa: Suno-like song generation from lyrics + tags.	`media/heartmula`
`songsee`	Audio spectrograms/features (mel, chroma, MFCC) via CLI.	`media/songsee`
`spotify`	Spotify: play, search, queue, manage playlists and devices.	`media/spotify`
`youtube-content`	YouTube transcripts to summaries, threads, blogs.	`media/youtube-content`

mlops

Skill	Description	Path
`audiocraft-audio-generation`	AudioCraft: MusicGen text-to-music, AudioGen text-to-sound.	`mlops/models/audiocraft`
`axolotl`	Axolotl: YAML LLM fine-tuning (LoRA, DPO, GRPO).	`mlops/training/axolotl`
`dspy`	DSPy: declarative LM programs, auto-optimize prompts, RAG.	`mlops/research/dspy`
`huggingface-hub`	HuggingFace hf CLI: search/download/upload models, datasets.	`mlops/huggingface-hub`
`llama-cpp`	llama.cpp local GGUF inference + HF Hub model discovery.	`mlops/inference/llama-cpp`
`evaluating-llms-harness`	lm-eval-harness: benchmark LLMs (MMLU, GSM8K, etc.).	`mlops/evaluation/lm-evaluation-harness`
`obliteratus`	OBLITERATUS: abliterate LLM refusals (diff-in-means).	`mlops/inference/obliteratus`
`outlines`	Outlines: structured JSON/regex/Pydantic LLM generation.	`mlops/inference/outlines`
`segment-anything-model`	SAM: zero-shot image segmentation via points, boxes, masks.	`mlops/models/segment-anything`
`fine-tuning-with-trl`	TRL: SFT, DPO, PPO, GRPO, reward modeling for LLM RLHF.	`mlops/training/trl-fine-tuning`
`unsloth`	Unsloth: 2-5x faster LoRA/QLoRA fine-tuning, less VRAM.	`mlops/training/unsloth`
`serving-llms-vllm`	vLLM: high-throughput LLM serving, OpenAI API, quantization.	`mlops/inference/vllm`
`weights-and-biases`	W&B: log ML experiments, sweeps, model registry, dashboards.	`mlops/evaluation/weights-and-biases`

note-taking

Skill	Description	Path
`obsidian`	Read, search, create, and edit notes in the Obsidian vault.	`note-taking/obsidian`

productivity

Skill	Description	Path
`airtable`	Airtable REST API via curl. Records CRUD, filters, upserts.	`productivity/airtable`
`google-workspace`	Gmail, Calendar, Drive, Docs, Sheets via gws CLI or Python.	`productivity/google-workspace`
`linear`	Linear: manage issues, projects, teams via GraphQL + curl.	`productivity/linear`
`maps`	Geocode, POIs, routes, timezones via OpenStreetMap/OSRM.	`productivity/maps`
`nano-pdf`	Edit PDF text/typos/titles via nano-pdf CLI (NL prompts).	`productivity/nano-pdf`
`notion`	Notion API via curl: pages, databases, blocks, search.	`productivity/notion`
`ocr-and-documents`	Extract text from PDFs/scans (pymupdf, marker-pdf).	`productivity/ocr-and-documents`
`powerpoint`	Create, read, edit .pptx decks, slides, notes, templates.	`productivity/powerpoint`
`teams-meeting-pipeline`	Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions.	`productivity/teams-meeting-pipeline`

red-teaming

Skill	Description	Path
`godmode`	Jailbreak LLMs: Parseltongue, GODMODE, ULTRAPLINIAN.	`red-teaming/godmode`

research

Skill	Description	Path
`arxiv`	Search arXiv papers by keyword, author, category, or ID.	`research/arxiv`
`blogwatcher`	Monitor blogs and RSS/Atom feeds via blogwatcher-cli tool.	`research/blogwatcher`
`llm-wiki`	Karpathy's LLM Wiki: build/query interlinked markdown KB.	`research/llm-wiki`
`polymarket`	Query Polymarket: markets, prices, orderbooks, history.	`research/polymarket`
`research-paper-writing`	Write ML papers for NeurIPS/ICML/ICLR: design→submit.	`research/research-paper-writing`

smart-home

Skill	Description	Path
`openhue`	Control Philips Hue lights, scenes, rooms via OpenHue CLI.	`smart-home/openhue`

Skill	Description	Path
`xurl`	X/Twitter via xurl CLI: post, search, DM, media, v2 API.	`social-media/xurl`

software-development

Skill	Description	Path
`debugging-hermes-tui-commands`	Debug Hermes TUI slash commands: Python, gateway, Ink UI.	`software-development/debugging-hermes-tui-commands`
`hermes-agent-skill-authoring`	Author in-repo SKILL.md: frontmatter, validator, structure.	`software-development/hermes-agent-skill-authoring`
`node-inspect-debugger`	Debug Node.js via --inspect + Chrome DevTools Protocol CLI.	`software-development/node-inspect-debugger`
`plan`	Plan mode: write markdown plan to .hermes/plans/, no exec.	`software-development/plan`
`python-debugpy`	Debug Python: pdb REPL + debugpy remote (DAP).	`software-development/python-debugpy`
`requesting-code-review`	Pre-commit review: security scan, quality gates, auto-fix.	`software-development/requesting-code-review`
`spike`	Throwaway experiments to validate an idea before build.	`software-development/spike`
`subagent-driven-development`	Execute plans via delegate_task subagents (2-stage review).	`software-development/subagent-driven-development`
`systematic-debugging`	4-phase root cause debugging: understand bugs before fixing.	`software-development/systematic-debugging`
`test-driven-development`	TDD: enforce RED-GREEN-REFACTOR, tests before code.	`software-development/test-driven-development`
`writing-plans`	Write implementation plans: bite-sized tasks, paths, code.	`software-development/writing-plans`

yuanbao

Skill	Description	Path
`yuanbao`	Yuanbao (元宝) groups: @mention users, query info/members.	`yuanbao`

19 KiB Raw Blame History