Development
debug-issue
Structured workflow for debugging a reported or reproduced issue. Use when the user asks to debug a bug, find root cause, or fix a failing scenario.
girijashankarj · AI review on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add girijashankarj/cursor-handbook --skill debug-issueAbout this skill
name: debug-issue description: Structured workflow for debugging a reported or reproduced issue. Use when the user asks to debug a bug, find root cause, or fix a failing scenario.
Skill: Debug issue
Trigger
When the user asks to debug a bug, find the root cause, or fix a failing scenario.
Steps
- Reproduce — Run or describe steps to reproduce; capture error message and stack if any.
- Isolate — Narrow to the smallest repro (single request, single file, single branch).
- Hypothesize — List 2–3 likely causes (e.g. null input, wrong config, race).
- Verify — Add a log, assertion, or minimal test to confirm one cause.
- Fix — Apply minimal code change; add or update a test to prevent regression.
- Confirm — Run type-check and relevant tests.
Rules
- Do not change unrelated code.
- Prefer adding a test that fails before the fix and passes after.