hermes-my-skills: developer tool for Hermes Agent

CLI to inventory, export and safely merge learned skills across Hermes Agent profiles

What hermes-my-skills does

hermes-my-skills is a command-line tool written in Python that works on the files Hermes Agent keeps on disk. It scans one or all profiles and lists skills that carry evidence of being learned, each tagged with a provenance class such as agent-created, ledger-created, ledger-modified, official-learned, hub-learned or local-unmanaged. The README notes that agent-created rests on a created_by: agent marker and is not proof of original authorship.

Selected skills can be exported to a tar.gz holding full skill directories and a manifest, then imported into another profile. Conflicts are skipped by default, a replace mode backs up the existing copy first, and an archived incoming variant never overwrites an active skill. Packages leave out API keys, sessions, memories, cron jobs and provider configuration, and imports check content hashes and reject path traversal. No Hermes Python internals are imported and there are no runtime dependencies.

Key features

Lists evidence-backed skills per profile with six provenance classes
Exports complete skill directories plus a manifest to a tar.gz
Imports into a target profile with skip, prefer-profile or replace conflict handling
Backs up existing copies before replacing them
Excludes API keys, sessions, memories, cron jobs and model configuration from packages
Finds the Hermes home from --home, HERMES_HOME, %LOCALAPPDATA%/hermes or ~/.hermes

When to use it

Moving skills an agent learned in one profile into a fresh profile
Keeping a portable backup of learned skills before reinstalling Hermes Agent
Choosing one profile's version when the same skill differs across profiles

Who it is for: Hermes Agent users who run several profiles or want to back up and move the skills their agents have learned.

How it fits with Hermes Agent

It is an independent third-party tool built around Hermes Agent profiles, the curator ledger and skill directories. The README states it is not affiliated with or endorsed by Nous Research.

How to install hermes-my-skills

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

pipx install hermes-my-skills
uv tool install .

Requirements: A Hermes Agent home directory (~/.hermes or HERMES_HOME); no runtime dependencies

Note: The README says the PyPI install applies after release, so a checkout install with uv may be needed.

FAQ

What is hermes-my-skills?

hermes-my-skills is a Python CLI that inventories skills learned inside Hermes Agent profiles, exports them as a package and merges selected ones into another profile. It classifies each skill by the evidence of where it came from.

How do I install hermes-my-skills?

Run pipx install hermes-my-skills once it is published on PyPI, or run uv tool install . from a checkout of the repository. The README says the PyPI route applies after release.

Does hermes-my-skills copy my API keys or memories?

No. The README says packages contain only selected skill directories, their support files and a manifest, and exclude API keys, authentication files, sessions, memories, cron jobs and provider configuration.