Skills Overview

What this page covers

Skills are reusable, on-demand knowledge documents that Hermes loads when a task needs a specific workflow. They reduce repeated prompting and let Hermes improve over time by saving procedures, pitfalls, and verification steps.

Hermes changes quickly, so treat the official documentation as the source of truth and use the built-in CLI to inspect the local install before editing config by hand.

Fast path

```bash

hermes skills list

```

```bash

hermes skills browse

```

```bash

hermes skills search github

```

```bash

hermes skills install <skill-id>

```

```bash

hermes skills inspect <skill-id>

```

```bash

hermes chat --toolsets skills -q "What skills are installed?"

```

Practical checklist

  • Skills live in the active profile under `~/.hermes/skills/` unless external skill directories are configured.
  • Use `skills_list`/`skill_view` in-agent or `hermes skills list`/`inspect` at the CLI to avoid loading unnecessary content.
  • Create or patch skills after repeatable workflows, user corrections, or hard-won debugging lessons.
  • Skill frontmatter should include a concise name, description, version, and relevant tags/platforms where useful.
  • Use support files under `references/`, `templates/`, `scripts/`, or `assets/` for longer reusable material.

Common pitfalls

  • Writing huge one-off session notes as a skill instead of a reusable procedure.
  • Forgetting profile isolation; a skill in one profile may not exist in another.
  • Deleting skills without merging useful content or noting what absorbed them.

Verification checklist

  • `hermes skills list` shows the expected skill.
  • A slash command or explicit skill load works in a fresh session.
  • The skill has clear trigger conditions, steps, pitfalls, and verification.

Official reference

https://hermes-agent.nousresearch.com/docs/user-guide/features/skills/