hermes skills Command — Complete Reference & Examples

Overview

hermes skills searches, installs, inspects, audits, configures, and manages skills from skills.sh, well-known agent skill endpoints, GitHub, ClawHub, and other registries.

hermes skills <subcommand>

Subcommands

browse

Browse all available skills (paginated).

hermes skills browse [--page PAGE] [--size SIZE] [--source SOURCE]

search <query>

Search skill registries by query.

hermes skills search "web scraping" [--source SOURCE] [--limit LIMIT] [--json]

install <identifier>

Install a skill from an identifier (e.g. openai/skills/skill-creator) or a direct URL to a SKILL.md file.

hermes skills install openai/skills/skill-creator [--category CATEGORY] [--name NAME] [--force] [--yes]

inspect <identifier>

Preview a skill without installing it.

hermes skills inspect openai/skills/skill-creator

list

List installed skills.

hermes skills list [--source SOURCE] [--enabled-only]

check [name]

Check installed hub skills for updates.

hermes skills check [google-workspace]

update [name]

Update installed hub skills.

hermes skills update [google-workspace]

audit [name]

Re-scan installed hub skills.

hermes skills audit [--deep] [google-workspace]

uninstall <name>

Remove a hub-installed skill.

hermes skills uninstall google-workspace

reset <name>

Reset a bundled skill — clear its ‘user-modified’ tracking so updates work again.

hermes skills reset google-workspace [--restore] [--yes]

list-modified

List bundled skills you’ve edited (the ones hermes update keeps).

hermes skills list-modified [--json]

diff <name>

Show how your copy of a bundled skill differs from the stock version.

hermes skills diff google-workspace

opt-out

Stop bundled skills from being seeded into this profile.

hermes skills opt-out [--remove] [--yes]

opt-in

Re-enable bundled-skill seeding (undo opt-out).

hermes skills opt-in [--sync]

repair-official <name>

Backfill or restore official optional skills from repo source. Use all for every optional skill.

hermes skills repair-official all [--restore] [--yes]

publish <skill_path>

Publish a skill to a registry.

hermes skills publish ./my-skill [--to github|clawhub] [--repo REPO]

snapshot {export,import}

Export or import skill configurations.

hermes skills snapshot export skills.json
hermes skills snapshot import skills.json [--force]

tap {list,add,remove}

Manage skill sources (taps).

hermes skills tap list
hermes skills tap add owner/repo
hermes skills tap remove tap-name

config

Interactive skill configuration — enable/disable individual skills.

hermes skills config

Examples

# Search for skills
hermes skills search "web scraping" --limit 5

# Install a skill
hermes skills install openai/skills/skill-creator

# List enabled skills for a profile
hermes skills list --enabled-only -p work

# Update all hub skills
hermes skills update

# Review and reset local changes
hermes skills diff google-workspace
hermes skills reset google-workspace --restore

Tips

• Use hermes skills list --enabled-only -p <profile> to see exactly which skills load for that profile.
• After editing a bundled skill, run hermes skills diff <name> and hermes skills reset <name> to resume clean updates.
• opt-out stops new bundled skills from being seeded; existing skills are left untouched unless you pass --remove.
• snapshot export / snapshot import are useful for backing up or migrating skill selections.