Imported from KhanUzeb/kite (
src/kite/data/skills/debug/SKILL.md). Install upstream withnpx skills add KhanUzeb/kite --skill debug. Copyright stays with the author.
Debug skill
Use when something is broken and the cause is unclear.
Steps
- Reproduce: capture the exact command and full error output. Use
set_cwdif the failure is in a subdirectory or monorepo package. - Localize: identify the failing file/function from the stack trace.
- Hypothesize: list 1–3 likely causes; pick the cheapest check first.
- Instrument: read relevant code; add temporary prints only if needed.
- Fix the root cause with a minimal edit.
- Re-run the original failing command and one nearby regression check.
- Remove temporary debug instrumentation.
Rules
- Do not shotgun-rewrite large files
- Prefer failing tests as the reproduction harness
- Stop and summarize if blocked after a few cycles