GSD Hermes: skill pack for Hermes Agent

What GSD Hermes does

gsd-hermes is the Hermes-first distribution of Get Shit Done, an upstream planning, execution, review and shipping workflow. It installs the /gsd-* commands as Hermes skills, including /gsd-new-project, /gsd-plan-phase, /gsd-execute-phase and /gsd-ship, with /gsd-help to verify the install. A global install writes into the Hermes home directory. A local install keeps an inspectable skill tree in ./.gsd-hermes and links it into Hermes through skills.external_dirs, because Hermes has no per-project skills root.

Its main addition is strict provider-routed execution. The model_overrides setting chooses a model per agent, such as gsd-executor or gsd-verifier. A hermes/ prefix runs the agent through hermes chat with terminal and file toolsets, openai/ and gpt- models go through codex exec, anthropic/ and claude- models go through claude -p, and anything unsupported fails fast with diagnostics. The point is that a configured GPT executor never quietly runs as a Claude subprocess. The README notes that upstream GSD now has basic Hermes support, and this package stays close to upstream while keeping the stricter routing layer.

Key features

/gsd-* planning, execution, review and shipping commands inside Hermes
Global install or project-linked local install
Per-agent model_overrides for planner, executor and verifier agents
hermes/, openai/ and anthropic/ routing to Hermes chat, Codex CLI or Claude Code CLI
Fail-fast diagnostics instead of silent fallback
npx installer

When to use it

Running a phase-based project workflow from inside Hermes
Assigning different models to the executor and verifier agents
Keeping a repo-visible skill tree for one project

Who it is for: Developers who use the Get Shit Done workflow and want it to run natively in Hermes Agent with predictable model routing.

How it fits with Hermes Agent

A Hermes-first distribution that installs skills into the Hermes home directory, or links a project skill tree through skills.external_dirs in config.yaml.

How to install GSD Hermes

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

npx gsd-hermes@latest --hermes --global
npx gsd-hermes@latest --hermes --local

Requirements: Hermes Agent; Codex CLI or Claude Code CLI only if you route agents to OpenAI or Anthropic models

FAQ

What is GSD Hermes?

GSD Hermes is the Hermes-first distribution of the Get Shit Done workflow. It installs the /gsd-* commands into Hermes Agent and adds strict per-agent model routing.

How do I install GSD Hermes?

Run npx gsd-hermes@latest --hermes --global to install into your Hermes home, or --local to link a skill tree inside one project. Then run /gsd-help in Hermes to verify.

How does GSD Hermes route models to agents?

The model_overrides setting names a model per agent. A hermes/ prefix uses Hermes chat, openai/ and gpt- models use Codex CLI, anthropic/ and claude- models use Claude Code CLI, and unsupported models fail with diagnostics.