mattpocock-skills
claudeMatt Pocock's agent skills for real engineering (grilling, spec/ticket flows, TDD, code review, domain modelling and more).
39 skills
Spawn worker sessions and answer their permission prompts from one manager session.
Plugin supervisor from marketplace claude-supervisor in bborbe/claude-supervisor. Commands read from the repo's manifest — 2 days ago.
This plugin runs code on your machine — its hooks fire automatically on events like tool use. The exact commands are listed below; read them before installing.
asked-ledgerholdopen-itemssupervising-workers/supervisor:attention-nextWhat's next on the attention stack — show open items, answer one in chat, and deliver the answer to the session that asked
/supervisor:closeClose ONE finished session — a worker whose task is terminal or deferred, or a goal/topic manager whose page is handed over, ended or parked — idle, and holding no gate. Closes a tab by killing its pane and a headless worker by SIGTERM on its registry pid, running the same guards for both. Refuses i
/supervisor:fleet-driveONE round of the fleet loop — sweep, diff against the previous sweep, classify every peer (progressing / stalled / parked / done), dispatch the drive leg, act within a strict autonomy boundary, render and re-arm. The same round the fleet loop's wakeup runs, and runnable by hand. Repeats by default a
/supervisor:fleet-loopArm the stateful fleet loop — invoked ONCE, then every wakeup runs the round `/supervisor:fleet-drive`. Repeats by default at its `--interval` (default 15 min) via ScheduleWakeup; TTS on problems (voice-mode gated); routes to managers. Never re-invoked from a wakeup.
/supervisor:fleet-resetClear the fleet's remembered state — stop every session, empty the five stores, and (only behind a separate opt-in) strip the task-file links a keep-alive leg resumes. The strip unlinks only a session that is positively ABSENT. Destructive; refuses without a confirm token.
/supervisor:fleet-statusRead-only fleet roster — every peer Claude Code session, its live status, and its vault task mapping. Zero side effects. Ends with a blocked-by-you jump list (waiting sessions + clickable jump links).
/supervisor:fleet-triageOne pass over every live Claude Code session — classify each into CLOSED / OPERATOR / EXTERNAL / LIVE-IDLE HEADLESS / STUCK / WORKING, close the finished (headless workers included, via `close-worker.py`), drive everything that is not genuinely blocked on something outside the fleet, post a card for
/supervisor:fleet-verifyVerify the fleet layer's own contract — five gated checks, read-only, ending in a numbered fix list
/supervisor:fleet-workersShow all supervisor workers and everything awaiting approval
/supervisor:goal-answerAnswer a pending worker permission prompt
/supervisor:goal-drainAnswer every pending permission by policy and escalate the rest
/supervisor:goal-driveONE round of the manager loop for ONE subject — reap the finished, nudge the stuck, spawn on the handover, classify, render and re-arm. The same round the manager loop's wakeup runs, and runnable by hand. Name via $1, or detected from the session when omitted; the branch (topic vs goal) is auto-dete
/supervisor:goal-loopRun the manager loop for ONE topic OR ONE goal — watch its declared set + task files (default 15 min, `--interval`), detect problems, TTS the human (voice-mode gated), print a status table, recommend new sessions and session closes. Name via $1, or detected from the session when omitted; the branch
/supervisor:goal-spawnSpawn a supervisor worker for a task
/supervisor:goal-statusRead-only goal-or-topic snapshot — ONE goal's declared task set (from `24 Goals/`) or ONE topic's declared goal set (from `23 Topics/`) *(operator's vault; not shipped with this plugin)*, its sessions, a status table with bucket icons, and a blocked-by-you jump list (clickable jump links). No vault
/supervisor:goal-verifyVerify one topic or goal and suggest the fixes — seven gated checks, read-only, ending in a numbered fix list
/supervisor:inboxThe operator's approval inbox — every task at phase: todo, and the three verbs that move one
/supervisor:jumpJump to a Claude Code session's WezTerm tab. Bare = newest session needing attention; or by tab id, tab:<N>, pane:<N>, or a title substring. The executor for the `/supervisor:jump <pane-id>` lines that the fleet-status, fleet-loop, goal-status and goal-loop commands print but never run — those comma
/supervisor:open-a2aOpen a name through the a2a-worker-controller — resolves it with /supervisor:open's own gates, then creates every worker on the controller, the backend chosen by the task's `target:` frontmatter. Manager-tier, like /supervisor:open. Name via $ARGUMENTS; optional --task/--goal/--topic, --vault, --fir
/supervisor:openOpen the right thing for a name — resolves it to a task, goal or topic, then jumps to its live session, resumes its recorded session, or starts a new one. Batch mode opens every task flagged for today. Name via $ARGUMENTS; optional --task/--goal/--topic, --vault, --color, --flagged, --first-step.
/supervisor:read-guidesRead all supervisor guides for context before working — session tiers (which commands each session may run) plus the fleet-surface spec
/supervisor:readyReady ONE named task and open it — run the audit → repair → re-audit loop in a sub-agent until the audit returns zero hard-gate failures, then act on the Gate 2 verdict: open via `/supervisor:open`, or escalate naming the gap. Cross-tier — runnable by the fleet manager and by a goal/topic manager. I
/supervisor:resetRe-discover this manager's state from disk rather than delete it. The reset contract is the vault's Manager Session runbook § Reset; this file owns the invocation and the report.
/supervisor:restartRestart ONE named session — worker or manager — in a single verb: kill its registry pid, resume the same session id in a new tab in its own role colour, and tell it what changed (a manager is told to re-arm its loop). Takes a session id (or a pid). Refuses on a dirty worktree the target owns alone,
/supervisor:steps:act/supervisor:steps:adopt/supervisor:steps:attention-watcher/supervisor:steps:auto-compaction/supervisor:steps:cause-verify/supervisor:steps:confirm-candidates/supervisor:steps:covered-subject-invariant/supervisor:steps:drive/supervisor:steps:escalate/supervisor:steps:flagged-open/supervisor:steps:fleet-round-tail/supervisor:steps:fleet-triage-act/supervisor:steps:fleet-triage-load-path/supervisor:steps:fleet-triage-render/supervisor:steps:fleet-triage-rules/supervisor:steps:fleet-triage-state/supervisor:steps:fleet-triage-sweep/supervisor:steps:fleet-triage-tier/supervisor:steps:fleet-triage-verify/supervisor:steps:goal-classify/supervisor:steps:goal-closure/supervisor:steps:goal-coverage/supervisor:steps:goal-drive/supervisor:steps:goal-gates/supervisor:steps:goal-handoff/supervisor:steps:goal-parked/supervisor:steps:goal-repair/supervisor:steps:goal-resolve/supervisor:steps:goal-spawn/supervisor:steps:goal-sweep/supervisor:steps:goal-under-target/supervisor:steps:goal-unowned/supervisor:steps:keepalive-decision-parks/supervisor:steps:keepalive-stood-down/supervisor:steps:keepalive-topicless-goals/supervisor:steps:keepalive/supervisor:steps:manager-reap/supervisor:steps:needs-input/supervisor:steps:open-items/supervisor:steps:open/supervisor:steps:output-shape/supervisor:steps:own-parks/supervisor:steps:persist/supervisor:steps:propose-manager/supervisor:steps:re-arm/supervisor:steps:readings/supervisor:steps:reap/supervisor:steps:round-liveness/supervisor:steps:round-quiet/supervisor:steps:round-readings/supervisor:steps:round-self-improvement/supervisor:steps:round-tail/supervisor:steps:rules/supervisor:steps:service-guard/supervisor:steps:sweep/supervisor:steps:topic-keepalive-outcome/supervisor:steps:topic-resolve/supervisor:steps:topic-sweep/supervisor:steps:voice-notify/supervisor:steps:worker-channels/supervisor:stop/supervisor:topic-drive/supervisor:topic-loop/supervisor:topic-spawn/supervisor:topic-status/supervisor:topic-verify/supervisor:who-needs-me/supervisor:who-needs-my-help/supervisor:worker-drive/supervisor:worker-restartfleet-drivePerform the fleet sweep's drive leg — read the digest render at the `payload=` path the caller passes, split its `parked` rows into revive (observed routine-continue closer, no verified blocker) and blocked (verified blocker), suppress re-nudges through a session-keyed ledger, close a nudged row sti
fleet-flagged-open-actorPerform the fleet round's flagged-open leg — invoke `/supervisor:open --flagged` so every row the operator marked for today is opened, print every `REFUSED` line verbatim, open nothing a refusal names, and record the leg's `operator-flagged` count in the round's digest — then return the ≤ 1 KB verdi
fleet-keepalive-actorPerform the fleet round's keep-alive leg — restart lapsed topic managers, resume due park watches, nudge watchers, resume dead workers; return the ≤ 1 KB hand-back. Router row 5b of /supervisor:fleet-drive.
fleet-open-actorPerform the fleet round's open leg — run `open-queue.py --json` once, write its rendered block to this round's payload, run every `selected[].action` verbatim so each admitted row opens through `/supervisor:open`, and return the ≤ 1 KB verdict hand-back. Dispatched by router row 16 of /supervisor:fl
fleet-sweep-readerCompute the fleet sweep's read half (Steps 0b–3 of /supervisor:fleet-loop) — read the four channels and the open-items ledger, diff against the previous snapshot, run the orphan reverse index, find collision and unmanaged-topic candidates, classify every session, persist the next snapshot through fl
gate-relay-readRead a blocked tab worker's pane and return a compact per-pane summary of what it is waiting on, so the manager can ask the operator without paying the pane-dump cost in its own context. Use when the attention feed or a roster read shows a tab worker blocked and its live question is needed before su
gate-relay-sendDeliver an operator's already-given answer into a blocked tab worker's pane, verifying the gate is still open first and handing over a jump link instead whenever the pane holds a modal, a wizard, or a production-touching question. Use when the operator has answered a batched manager question in the
goal-drivePerform the worker sweep's act leg for ONE subject — reap the finished, nudge stuck or error-marked workers, run the auto-resume gate on confirmed orphans. Reap runs BEFORE drive, always. Dispatched by `/supervisor:goal-drive` (operator, by hand) and by `/supervisor:goal-loop` (every tick, after its
goal-spawn-readerCompute the spawn decisions for a goal manager's handed-over `To open` / `To resume` rows — read each row's task file, apply the approval, hold, role, dependency, target, shipping, mode and cap gates, resolve the vault and cwd, and return the ≤ 1 KB per-row call shape plus the payload path. Dispatch
goal-sweep-readerCompute the worker sweep's read-and-render half — read a tracked task set, classify into the bucket set the vault's own runbook declares, extract full session-id sets with `python3 scripts/session-ids.py` (by field, never by line start, never by shape), flag orphan candidates and live collisions, re
goal-verifyRun the seven gated checks for ONE subject — a goal or a topic — and return the report plus a numbered fix list. Dispatched by `/supervisor:goal-verify` (operator, by hand). It owns the seven per-step forks and the report shape; it mutates nothing.
goal-wranglerRun the routine approval loop over headless supervisor workers so the manager session is not occupied by approvals. Use when headless workers (spawned with interactive:false) are running and their permission prompts should be answered by policy rather than by the operator.
round-readings-readerCompute a manager round's readings — the four verdict families (liveness, in-flight, attention feed, external wait) for every tracked row — by running scripts/round-readings.py over the caller's tracked set, recording the result on the round's receipt, and returning the ≤ 1 KB verdict hand-back plus
topic-drivePerform the TOPIC sweep's act leg for ONE topic — keep each declared goal's manager alive (jump / resume / restart / leave / crash-loop), then rank and name the goals that should take the free N slots. Dispatched by /supervisor:topic-drive (operator, by hand) and by /supervisor:topic-loop (every tic
topic-sweep-readerCompute the TOPIC sweep's read-and-render half — read the topic page's declared goal list, and for each goal read its status, phase, success-criterion tally and the state of the goal manager running on it, then render the goal table. Use when a topic command (/supervisor:topic-loop or /supervisor:to
topic-verifyRun the sixteen-row check for ONE TOPIC — eleven disk-backed page-consistency checks, one coverage read and four advisory rows — and return the report plus a numbered fix list. Dispatched by /supervisor:topic-verify (operator, by hand). It owns the per-row forks and the report shape; it mutates noth
worker-drive-readerCompute the read half of one /supervisor:worker-drive round — the session diagnosis (the measured window, loop check, anchor re-verify, drift check) and the drive table (every open item, its evidence rating, blocker, lever and owner) — and return the ≤ 1 KB verdict hand-back. Use when /supervisor:wo
python3
python3
python3
python3
python3
python3
python3
Matt Pocock's agent skills for real engineering (grilling, spec/ticket flows, TDD, code review, domain modelling and more).
39 skills
Persistent memory for Claude Code: the next session starts where the last one left off.
29 skills · 1 MCP server · hooks
Cross-session memory and token savings for coding agents.
6 skills · 1 agent · 1 MCP server · hooks
Up-to-date documentation lookup. Pull version-specific documentation and code examples directly from source repositories into your coding agent's context.
1 MCP server
AI memory system — mine projects and conversations into a searchable palace. 47 MCP tools, auto-save hooks, guided setup.
3 skills · 6 commands · 1 MCP server · hooks
Reliable automation, in-depth debugging, and performance analysis in Chrome using Chrome DevTools and Puppeteer
8 skills · 1 MCP server
This page updates itself from your repo. Add the badge to your README, or get it Featured to pin it above the organic results with a followed link to your site.