Skills
All skill surfaces are invoked via /{skill-name} in Claude Code.
Skill manpages are operator reference pages — distinct from the agent-facing
SKILL.md files that govern execution. See the
Documentation Taxonomy for the
audience split.
Namespace Routers
First-stage intent routers. Pick the namespace that matches your intent, then invoke the concrete skill directly.
| Skill |
Description |
/gz-workflow |
End-to-end workflow intents — design, plan, implement, verify, justify, plan-audit |
/gz-governance |
ADR, OBPI, and ledger governance intents |
/gz-quality |
Quality and complexity intents — check, lint, tech debt, complexity |
/gz-project |
Project lifecycle intents — init, requirements, constitution, competitor-radar |
/gz-context |
Context preservation and orientation intents — handoff, parity, map |
/gz-manage |
Repo and release management intents — git-sync, issues, releases, tidy |
/gz-chores |
Maintenance and code-quality chore intents — chore runner, deps upgrade, foundation triage, pythonic patterns, config check, cli audit |
ADR Lifecycle
| Skill |
Description |
/gz-adr-create |
Create and book a GovZero ADR with its OBPI briefs |
/gz-adr-evaluate |
Post-authoring quality evaluation for ADRs and OBPIs |
/gz-adr-promote |
Promote a pool ADR into canonical ADR package structure |
/gz-adr-status |
Show ADR table or focused lifecycle and OBPI detail |
/gz-design |
Collaborative design dialogue that produces GovZero ADR artifacts |
/gz-rnd |
Governed R&D session that retains and routes exploratory design outcomes |
/gz-plan |
Create ADR artifacts for planned change |
ADR Operations
| Skill |
Description |
/gz-adr-emit-receipt |
Emit ADR receipt events with scoped evidence payloads |
/gz-adr-map |
Build ADR-to-artifact traceability using gz state and repository search |
/gz-adr-sync |
End-to-end ADR governance sync — evidence discovery, ledger reconciliation, and registration (Layers 1-3) |
/gz-advisor-qc |
Judge the information-retained-per-byte of a candidate rendition and record the verdict via gz content advise-rendition — advisory, never gating |
ADR Audit
OBPI Pipeline
| Skill |
Description |
/gz-obpi-lock |
Claim or release OBPI-level work locks for multi-agent coordination |
/gz-obpi-pipeline |
Post-plan OBPI execution pipeline — implement, verify, present, sync |
/gz-obpi-sync |
Audit briefs against evidence, fix stale metadata, write ledger proof |
/gz-obpi-brief-drift |
Reconcile an OBPI brief against project state across five drift dimensions |
/gz-obpi-simplify |
OBPI-scoped code review for reuse, quality, and efficiency |
/gz-obpi-specify |
Create and author OBPI briefs linked to parent ADR items |
/gz-plan-audit |
Pre-flight alignment audit — verify plan aligns with OBPI brief |
/gz-justify |
Pre-execution reasoning walkthrough for GHIs, OBPIs, and drafts |
Code Quality
| Skill |
Description |
/gz-arb |
Quality evidence workflow using native gz lint/typecheck/test/check |
/gz-check |
Run full quality checks in one pass |
/gz-chore-runner |
Run a gzkit chore end-to-end (show, plan, advise, execute, validate) |
/gz-cli-audit |
Audit CLI documentation coverage and headings |
/gz-complexity-advisor |
Preview complexity advisor diagnosis, understand auto-chain context, or check intrinsic complexity attestation guidance |
/gz-complexity-guide |
Preview authoring-time complexity hints before committing |
/gz-complexity-distill |
Run a complexity distillation pass against the exemplar corpus to refresh distilled-characteristics doctrine |
/gz-content-remember |
Capture an addressed entry into a surface's append-only corpus via gz content remember, never editing a rendered surface |
/gz-insights-remember |
Record a course-correction, defect, defect-resolution, or discovery insight via the governed gz insights remember verb, never hand-appending the jsonl |
/gz-content-compose |
Validate and stage a candidate rendition via gz content compose — validates invariant-floor compliance, computes byte evidence, writes candidate artifact |
/gz-context-diet |
Trim per-turn agent context weight by lifting narrative to docs/governance/ |
/gz-deps-upgrade |
Refresh global uv tools, Python 3.13.x runtime, pyproject.toml pins/floors, and uv.lock to current PyPI latest |
/gz-pythonic-pattern-detect |
Surface Pythonic-design-pattern refactor candidates after ADR closeout (AST scanner over src/) |
/gz-pythonic-pattern-apply |
Capture before/after evidence with mechanical-delta proof when a Pythonic-pattern rewrite is applied |
/gz-tech-debt-review |
Survey the codebase for technical debt and recommend resolutions across many debt classes |
Governance Infrastructure
| Skill |
Description |
/gz-constitute |
Create constitution artifacts |
/gz-implement |
Run Gate 2 verification and record result events |
/gz-airlock |
Cross the airlock entry/exit membrane — inspect a seam-map, account for drift, or make a governed ad-hoc reconnaissance entry |
/gz-init |
Initialize gzkit governance scaffolding for a repository |
/gz-ontology |
Image the governance shape with the read-only ontology sonar |
/gz-prd |
Create product requirement artifacts |
/gz-state |
Query artifact relationships and readiness state |
/gz-status |
Report gate and lifecycle status across ADRs |
/gz-validate |
Validate governance artifacts against schema rules |
Agent Operations
| Skill |
Description |
/gz-big-picture |
Explain project value, trajectory and architecture in a retained, ledger-recorded report |
/ghi-author |
Author a GitHub Issue for a defect, enhancement, or investigation surfaced in flight |
/gz-issue-file |
Cross-repo defect/enhancement filing wrapper for gzkit-owned surfaces (routes to tvproductions/gzkit) |
/ghi-close |
Do the work described in a GHI, verify artifacts, and close with evidence |
/ghi-triage |
Evaluate and triage all open GitHub Issues with routing + urgency scoring |
/gz-foundation-triage |
Rank the in-flight foundation backlog by priority — diagnosis only, ephemeral ranked report |
/gz-health-audit |
Namespace router → the four-axis health and integrity audit; owns the ordering and the net-surface-reduction budget rule |
/gz-intent-trace |
Trace sampled ADRs from declared intent to shipped surface; routes every gap as a correction under its owning ADR |
/git-sync |
Run the guarded repository sync ritual with lint/test gates |
/gz-agent-sync |
Synchronize generated control surfaces and skill mirrors |
/gz-check-config-paths |
Validate configured and manifest path coherence |
/gz-competitor-radar |
Track competitor status, trajectory, and gzkit improvement opportunities |
/gz-flighttest |
Fly one flight-test sortie against a target repo to prove a gzkit workflow and harvest refinement feedback |
/gz-migrate-semver |
Record semver identifier migration events |
/gz-patch-release |
Orchestrate the GHI-driven patch release ceremony |
/gz-session-handoff |
Create and resume session handoff documents for agent context preservation |
/gz-how |
Answer how do I / what can I: the flows gzkit's skills belong to, their look-alikes and the full catalog |
/gz-skill-review |
Review a skill by re-verifying every claim against the code it wields |
/gz-mx |
Enter and exit the MX Maintenance Hangar — operator's interface to gz mx |
/gz-tidy |
Report maintenance findings (exit 3 on a breach); --fix regenerates control surfaces |
Cross-Repository