Skip to content
Apothem
Comparison

Apothem vs raw Hermes config

Hand-maintaining Hermes config versus managing it through Apothem's shared profile.

Hermes reads ~/.hermes/config.yaml. Apothem writes the native YAML config (projecting the profile's MCP inventory into mcp_servers) and installs shared command and skill cohorts under ~/.hermes/.apothem/support/skills/, which it lists under skills.external_dirs so Hermes loads them. Hermes's own skills.config holds per-skill settings, so Apothem does not author it.

Status

Preview. The Hermes adapter targets the current documented config file and skill-discovery surface. Non-skill cohorts remain Apothem support material.

Effort comparison

TaskRaw hand-configApothem-managed
Author reusable skillsHand-edit config and skill directoriesWrite once in the shared corpus
Keep cohorts aligned with other harnessesManual, per toolAutomatic on apothem update
Install / remove the configManualapothem install / apothem uninstall
Verify the config is correctManual inspectionapothem verify --harness hermes

What Apothem manages

The Hermes adapter writes config.yaml, wraps Apothem slash commands as skills, copies Apothem skills into the support directory, and keeps rules, templates, agents, and hook material under the Apothem support subtree. It also adds ~/.hermes/.apothem/support/skills to skills.external_dirs in config.yaml, so Hermes loads those skills. That list comes last in Hermes's documented precedence order, so a skill of the same name in your project or in ~/.hermes/skills/ is likely to take precedence over the Apothem copy; the Hermes docs reviewed do not state the clash rule.

Migration path

  1. Run apothem profile init to create the shared profile if you have not yet.
  2. Move reusable Hermes skills or command prompts into the shared corpus.
  3. Run apothem install --harness hermes to render the native config, which lists the support skill directory under skills.external_dirs, and to install the skills. apothem update keeps keys you add to config.yaml.
  4. Run apothem verify --harness hermes to confirm the config landed.

On this page