Menu
Reproduce, root-cause, and fix a bug with the smallest verified change. Writes investigation evidence to .context/debug.md and hands naturally to /test.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | debug |
| description | Reproduce, root-cause, and fix a bug with the smallest verified change. Writes investigation evidence to .context/debug.md and hands naturally to /test. |
Read the shared contracts before output: ../_shared/operator-output.md, ../_shared/attention-budget.md, ../_shared/evidence-record.md, ../_shared/state.md, ../_shared/cognitive-load.md, ../_shared/collaboration.md.
Replace guessing with a reproduction, causal model, fix, and proof.
Bug report, failing command/test, stack trace, user description, current diff, issue/PR, or production symptom.
Repo code/tests/logs, package source/docs when relevant, git history, current branch state, .context/ artifacts when present.
.context/debug.md.context/session-state.md.context/debug.md.Return root cause/fix decision, up to three evidence bullets including reproduction and verification, remaining risk, and next action. Suggest /test when broader test audit is useful; otherwise suggest /docs or /pr.
Stop if the bug cannot be reproduced, the reproduction contradicts the report, the fix requires an unchosen product decision, or verification cannot run.
Apply Emil Kowalski-style UI polish: interaction details, component feel, animation restraint, and invisible product quality. Uses progressive disclosure instead of long design essays.
Apply Emil Kowalski-style animation guidance for web interfaces: purposeful motion, correct easing, interruptibility, performance, reduced motion, and interaction feel.
Implement the requested change on the current branch using the best available contract: issue, architecture, user request, or repo evidence. Does not require /architect or /review to have run. Hands naturally to /test.
Triage and address PR review comments. Uses available issue/architecture/context when present, keeps evidence in .context/address.md, and does not require prior workflow phases.
Derive the smallest correct architecture from user intent, repo facts, and available workflow evidence. Writes the full architecture to .context/architecture.md and returns only the decision, tradeoff, risk, and next action.
Review the current PR for correctness, tests, maintainability, security, standards, and prior-findings risk. Keeps reviewer detail in .context/code-review.md and posts concise actionable GitHub review comments.