Files
hermes-agent/website/docs/reference/skills-catalog.md
Teknium 7c6c5619a7 docs(sidebar): collapse exploding skills tree to a single Skills node (#18259)
* docs(sidebar): collapse exploding skills tree to a single Skills node

The Skills sub-tree in the left sidebar expanded to 200+ entries
(22 bundled categories + 15 optional categories, every skill a page).
That's most of the nav on a first visit — docs for the actual product
get drowned in it.

Collapse the sidebar to:

  Skills
    godmode              (hand-written spotlight)
    google-workspace     (hand-written spotlight)
    Bundled catalog      (reference/skills-catalog — table of all bundled)
    Optional catalog     (reference/optional-skills-catalog — table of all optional)

Per-skill pages still generate and are still reachable at their URLs;
they're linked from the two catalog tables and from the Skills overview
page. They just don't appear in the left nav anymore.

sidebars.ts goes from 649 lines to 247. generate-skill-docs.py loses
the bundled/optional sidebar render helpers.

Also picks up incidental generator output drift on current main
(comfyui skill content refresh; 4 new skill pages for
devops-kanban-orchestrator, devops-kanban-worker,
productivity-here-now, productivity-shopify; two catalog refreshes).
These are what the generator produces on main today — keeping them
committed avoids the next docs build showing 'working tree dirty'.

* docs(sidebar): drop godmode and google-workspace spotlight pages

Keep the Skills sidebar node strictly principled: two catalog links,
nothing else. There was no rule for which skills got spotlight pages
and which got auto-generated pages — just that these two happened to
be hand-written first.

Both pages still build and are still reachable at
/docs/user-guide/skills/godmode and
/docs/user-guide/skills/google-workspace. They're linked from the
catalog tables and the Skills overview page.

Sidebar Skills node now:
  Skills
    ├── Bundled catalog
    └── Optional catalog
2026-04-30 23:08:22 -07:00

18 KiB

sidebar_position, title, description
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.

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

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, and create 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

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

social-media

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