Skills documentation
Agent Skills
Reference local AI agent skills, trigger phrases, source instructions, and bundled files.
caveman
>
diagnose
Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression.
grill-me
Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".
grill-with-docs
Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.
gsd-add-backlog
Add an idea to the backlog parking lot (999.x numbering)
gsd-add-phase
Add phase to end of current milestone in roadmap
gsd-add-tests
Generate tests for a completed phase based on UAT criteria and implementation
gsd-add-todo
Capture idea or task as todo from current conversation context
gsd-analyze-dependencies
Analyze phase dependencies and suggest Depends on entries for ROADMAP.md
gsd-audit-fix
Autonomous audit-to-fix pipeline — find issues, classify, fix, test, commit
gsd-audit-milestone
Audit milestone completion against original intent before archiving
gsd-audit-uat
Cross-phase audit of all outstanding UAT and verification items
gsd-autonomous
Run all remaining phases autonomously — discuss→plan→execute per phase
gsd-check-todos
List pending todos and select one to work on
gsd-cleanup
Archive accumulated phase directories from completed milestones
gsd-code-review
Review source files changed during a phase for bugs, security issues, and code quality problems
gsd-code-review-fix
Auto-fix issues found by code review in REVIEW.md. Spawns fixer agent, commits each fix atomically, produces REVIEW-FIX.md summary.
gsd-complete-milestone
Archive completed milestone and prepare for next version
gsd-debug
Systematic debugging with persistent state across context resets
gsd-discuss-phase
Gather phase context through adaptive questioning before planning. Use --auto to skip interactive questions (Codex picks recommended defaults). Use --chain for interactive discuss followed by automatic plan+execute. Use --power for bulk question generation into a file-based UI (answer at your own pace).
gsd-do
Route freeform text to the right GSD command automatically
gsd-docs-update
Generate or update project documentation verified against the codebase
gsd-execute-phase
Execute all plans in a phase with wave-based parallelization
gsd-explore
Socratic ideation and idea routing — think through ideas before committing to plans
gsd-fast
Execute a trivial task inline — no subagents, no planning overhead
gsd-forensics
Post-mortem investigation for failed GSD workflows — analyzes git history, artifacts, and state to diagnose what went wrong
gsd-health
Diagnose planning directory health and optionally repair issues
gsd-help
Show available GSD commands and usage guide
gsd-import
Ingest external plans with conflict detection against project decisions before writing anything.
gsd-insert-phase
Insert urgent work as decimal phase (e.g., 72.1) between existing phases
gsd-intel
Query, inspect, or refresh codebase intelligence files in .planning/intel/
gsd-join-discord
Join the GSD Discord community
gsd-list-phase-assumptions
Surface Codex's assumptions about a phase approach before planning
gsd-list-workspaces
List active GSD workspaces and their status
gsd-manager
Interactive command center for managing multiple phases from one terminal
gsd-map-codebase
Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents
gsd-milestone-summary
Generate a comprehensive project summary from milestone artifacts for team onboarding and review
gsd-new-milestone
Start a new milestone cycle — update PROJECT.md and route to requirements
gsd-new-project
Initialize a new project with deep context gathering and PROJECT.md
gsd-new-workspace
Create an isolated workspace with repo copies and independent .planning/
gsd-next
Automatically advance to the next logical step in the GSD workflow
gsd-note
Zero-friction idea capture. Append, list, or promote notes to todos.
gsd-pause-work
Create context handoff when pausing work mid-phase
gsd-plan-milestone-gaps
Create phases to close all gaps identified by milestone audit
gsd-plan-phase
Create detailed phase plan (PLAN.md) with verification loop
gsd-plant-seed
Capture a forward-looking idea with trigger conditions — surfaces automatically at the right milestone
gsd-pr-branch
Create a clean PR branch by filtering out .planning/ commits — ready for code review
gsd-profile-user
Generate developer behavioral profile and create Codex-discoverable artifacts
gsd-progress
Check project progress, show context, and route to next action (execute or plan)
gsd-quick
Execute a quick task with GSD guarantees (atomic commits, state tracking) but skip optional agents
gsd-reapply-patches
Reapply local modifications after a GSD update
gsd-remove-phase
Remove a future phase from roadmap and renumber subsequent phases
gsd-remove-workspace
Remove a GSD workspace and clean up worktrees
gsd-research-phase
Research how to implement a phase (standalone - usually use /gsd-plan-phase instead)
gsd-resume-work
Resume work from previous session with full context restoration
gsd-review
Request cross-AI peer review of phase plans from external AI CLIs
gsd-review-backlog
Review and promote backlog items to active milestone
gsd-scan
Rapid codebase assessment — lightweight alternative to /gsd-map-codebase
gsd-secure-phase
Retroactively verify threat mitigations for a completed phase
gsd-session-report
Generate a session report with token usage estimates, work summary, and outcomes
gsd-set-profile
Switch model profile for GSD agents (quality/balanced/budget/inherit)
gsd-settings
Configure GSD workflow toggles and model profile
gsd-ship
Create PR, run review, and prepare for merge after verification passes
gsd-stats
Display project statistics — phases, plans, requirements, git metrics, and timeline
gsd-thread
Manage persistent context threads for cross-session work
gsd-ui-phase
Generate UI design contract (UI-SPEC.md) for frontend phases
gsd-ui-review
Retroactive 6-pillar visual audit of implemented frontend code
gsd-undo
Safe git revert. Roll back phase or plan commits using the phase manifest with dependency checks.
gsd-update
Update GSD to latest version with changelog display
gsd-validate-phase
Retroactively audit and fill Nyquist validation gaps for a completed phase
gsd-verify-work
Validate built features through conversational UAT
gsd-workstreams
Manage parallel workstreams — list, create, switch, status, progress, complete, and resume
handoff
Compact the current conversation into a handoff document for another agent to pick up.
improve-codebase-architecture
Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/. Use when the user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more testable and AI-navigable.
prototype
Build a throwaway prototype to flesh out a design before committing to it. Routes between two branches — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route. Use when the user wants to prototype, sanity-check a data model or state machine, mock up a UI, explore design options, or says "prototype this", "let me play with it", "try a few designs".
setup-matt-pocock-skills
Sets up an `## Agent skills` block in AGENTS.md/CLAUDE.md and `docs/agents/` so the engineering skills know this repo's issue tracker (GitHub or local markdown), triage label vocabulary, and domain doc layout. Run before first use of `to-issues`, `to-prd`, `triage`, `diagnose`, `tdd`, `improve-codebase-architecture`, or `zoom-out` — or if those skills appear to be missing context about the issue tracker, triage labels, or domain docs.
tdd
Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD, mentions "red-green-refactor", wants integration tests, or asks for test-first development.
to-issues
Break a plan, spec, or PRD into independently-grabbable issues on the project issue tracker using tracer-bullet vertical slices. Use when user wants to convert a plan into issues, create implementation tickets, or break down work into issues.
to-prd
Turn the current conversation context into a PRD and publish it to the project issue tracker. Use when user wants to create a PRD from the current context.
triage
Triage issues through a state machine driven by triage roles. Use when user wants to create an issue, triage issues, review incoming bugs or feature requests, prepare issues for an AFK agent, or manage issue workflow.
write-a-skill
Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill.
zoom-out
Tell the agent to zoom out and give broader context or a higher-level perspective. Use when you're unfamiliar with a section of code or need to understand how it fits into the bigger picture.