Puppetmaster Learn
From its catalog listing
Turns a Puppetmaster swarm into a Hermes skill. Puppetmaster runs durable worker jobs (swarms and flow graphs) for an agent. When a Hermes session ends, this plugin finds the swarm that finished during that session in the session's directory and, if it produced findings or a patch, writes its goal and findings (title, location, severity, failure scenario, evidence) as a skill candidate under $HERMES_HOME/skills-candidates/. Promote it with `puppetmaster skills promote-candidate <slug>`. It never writes a live skill or starts an agent or job, and writes one candidate per job. Needs the Puppetmaster CLI (PyPI puppetmaster-ai).
Good to know before installing
at session end it reads the ending session's cwd and started_at from the Hermes session store (read-only, no messages), runs up to three read-only Puppetmaster CLI commands (last --json, status, artifacts) as child processes in that directory, 15 s timeout each, stdin closed, and reads the mcp_servers.puppetmaster entry of Hermes config.yaml (no credentials); it writes only under $HERMES_HOME/skills-candidates/; no network, no threads or background processes, no telemetry, no dependencies beyond the standard library.
From its catalog listing.
How to install
- Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
hermes plugins install puppetmaster-learn - Said no? Turn it on later:
hermes plugins enable puppetmaster-learn - Restart Hermes so it loads the plugin.
Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).
- Category
- Automation & multi-agent
- Maintained by
- professorpalmer (Community)
- Needs
- No API keys declared
- Adds hooks
on_session_finalize- Needs Hermes
- 0.20.4 or newer
- Version
- 0.2.1
- In the catalog
- 2026-11-14
Known issues (from its catalog listing)
- Gateway-owned sessions (hermes -z, TUI, desktop) drop plugin session-end messages today, so the notice does not show. The candidate is still written; `puppetmaster skills list-candidates` lists it.
- Only the latest Puppetmaster job of the session's directory is checked. If two swarms finish in one session, only the later one becomes a candidate.
Using the Hermes desktop app? See where plugins live

Full setup & settings ↗Source code ↗
More in automation & multi-agent
All automation & multi-agent plugins
New Hermes Agent updates every day on X. Follow @HermesWatcher