Skip to content

Hermes Agent Skills Guide

Hermes Agent from Nous Research reads SKILL.md files natively, with the same YAML frontmatter and folder layout Claude Code uses. Our skills install without conversion: a sync script symlinks 405 of them into ~/.hermes/skills/claude-skills/<domain>/<skill>/.

Install-tested in CI

Every pull request that changes skills installs the real hermes-agent package into an empty home directory, runs the sync, and fails unless hermes skills list shows every skill the sync installed.

Install

# 1. Hermes itself (a virtualenv keeps it isolated)
python3 -m venv ~/.venvs/hermes
~/.venvs/hermes/bin/pip install hermes-agent
export PATH="$HOME/.venvs/hermes/bin:$PATH"

# 2. Our skills
git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills
python3 scripts/sync-hermes-skills.py

Configure a model provider for Hermes as described in its README.

Verify

hermes skills list | grep -c claude-skills
# Expected: 405

Useful flags

Flag What it does
--domain engineering Install one domain only
--copy Copy files instead of symlinking (containers, shared filesystems)
--target <dir> Install somewhere other than ~/.hermes/skills
--dry-run --verbose Show what would be installed without writing anything
--json Machine-readable summary

Update

cd claude-skills
git pull
python3 scripts/sync-hermes-skills.py

Existing links are kept and new skills are added.