Skip to content

CodeSigils/hermes-skill-hq

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

hermes-skill-hq

THE skill knowledge base for any Hermes AI agent.

When you start a session, Hermes checks this first. It knows which skills exist, recommends ones you might need before you ask, and helps you create new ones for tasks that don't have one yet.


How It Works For You

You don't manage skills manually — Hermes does it.

At the start of each session, Hermes reads HQ's INDEX and keeps skill opportunities in mind. When it detects you're working on something that has a skill — even one you haven't loaded — it tells 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. That's it.


What HQ Does For You

What How
Skill discovery Knows ~2043 skills from the Hermes hub + skills.sh ecosystem
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
Self-maintaining INDEX grows as you use Hermes; skills you create get logged automatically

What You Can Do

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 offers to build one, validates it with test prompts, then adds it to INDEX.

Review what's in INDEX:

"Show me skills for Python development"

Hermes searches INDEX and the hub for relevant skills.

Periodic health check:

"Run kb-review"

Hermes checks INDEX for stale entries, missing skills, and outdated marketplace links.


Structure

~/.hermes/kb/           ← hermes-skill-hq (skill named "hermes-skill-hq", installed at standard KB path)
├── 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

Installation

git clone https://github.com/CodeSigils/hermes-skill-hq.git ~/.hermes/kb

Add to ~/.hermes/config.yaml if not already present:

external_dirs:
  - ~/.hermes/kb

Then run /reset to refresh Hermes's skills index.


For Hermes (How It Loads)

Hermes auto-discovers HQ from ~/.hermes/kb/ via external_dirs in config. After any edit, run /reset.


Maintenance

HQ updates itself as you use Hermes. Run kb-review monthly to:

  • Find stale entries in INDEX
  • Refresh marketplace links
  • Log skills you created but forgot to index

License: Personal knowledge base — not for redistribution.

About

THE definitive skill knowledge base for any Hermes AI agent. Curated task→skill INDEX, proactive advisor, marketplace navigation, skill-authoring companion.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors