Curated skill HQ for Hermes agents.
When loaded, HQ gives Hermes a fast map from real tasks to the right skills. It knows which skills exist, recommends likely matches, and gives maintainers a workflow for adding new skills when a common task has no good match yet.
HQ is an agent guide, not an always-on daemon.
After HQ is installed and loaded, Hermes can read HQ's INDEX and keep skill opportunities in mind. When it detects you're working on something that has a skill — even one you haven't loaded — it can tell you:
"I noticed you're working with ComfyUI images — want me to load
comfyui? It handles image and video generation."
You say yes or no. If a higher-priority system or developer instruction already requires a matching skill, Hermes may load it directly and tell you what it did.
| What | How |
|---|---|
| Skill discovery | Knows the local HQ INDEX and points to hub/marketplace fallback sources |
| Proactive recommendations | Suggests skills based on what you're working on |
| Gap detection | When a common task has no skill, it offers to create one |
| Maintenance workflow | Gives maintainers review, changelog, and indexing rules |
Request a skill:
"Help me work with Stable Diffusion"
Hermes checks INDEX → finds stable-diffusion-image-generation → offers to load it.
Ask for a new skill:
"I want to automate X but no skill exists for it"
Hermes can offer to build one, validate it with test prompts, and add it to INDEX after you approve the change.
Review what's in INDEX:
"Show me skills for Python development"
Hermes searches INDEX first, then the hub only if INDEX does not contain a good match.
Periodic health check:
"Run hq-review"
Hermes checks INDEX for stale entries, missing skills, and outdated marketplace links.
~/.hermes/hq/ ← hermes-skill-hq (skill named "hermes-skill-hq")
├── index/INDEX.md ← What skills exist for what tasks
├── advisory/ ← How Hermes detects skill opportunities
├── marketplaces/ ← Where to find skills beyond the hub
├── guides/ ← Skill authoring standards and deep-dive guides
└── maintenance/ ← Update workflow + changelog
git clone https://github.com/CodeSigils/hermes-skill-hq.git ~/.hermes/hqAdd to ~/.hermes/config.yaml if not already present:
skills:
external_dirs:
- ~/.hermes/hqThen run /reset to refresh Hermes's skills index.
Hermes discovers HQ from ~/.hermes/hq/ when that directory is listed under
skills.external_dirs in config. Load it like any other skill, for example with
/skill hermes-skill-hq in a session or hermes -s hermes-skill-hq at launch.
After install or edits, run /reset or start a fresh session so the skills
prompt index refreshes.
Run hq-review monthly to:
- Find stale entries in INDEX
- Refresh marketplace links
- Log skills you created but forgot to index
Repository-local agent editing rules live in AGENTS.md; runtime HQ behavior remains in SKILL.md.
License: No LICENSE file is currently present in this repository.