Debug Issue
- 1 installs
- 27 repo stars
- Updated April 25, 2026
- girijashankarj/cursor-handbook
Structured workflow to reproduce a bug, isolate it, hypothesize causes, verify one, apply a minimal fix, and confirm with tests.
About
Provides a step-by-step workflow for debugging a reported or reproduced issue down to root cause. A developer uses it when asked to find why a scenario is failing and fix it.
- Reproduce, isolate, hypothesize 2-3 causes, verify, fix
- Adds a regression test and re-runs type-check and tests
Debug Issue by the numbers
- 1 all-time installs (skills.sh)
- Ranked #488 of 596 Debugging skills by installs in the Skillselion catalog
- Data as of Jul 22, 2026 (Skillselion catalog sync)
npx skills add https://github.com/girijashankarj/cursor-handbook --skill debug-issueAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 1 |
|---|---|
| repo stars | ★ 27 |
| Last updated | April 25, 2026 |
| Repository | girijashankarj/cursor-handbook ↗ |
What it does
Structured workflow to reproduce a bug, isolate it, hypothesize causes, verify one, apply a minimal fix, and confirm with tests.
Files
Skill: Debug issue
Trigger
When the user asks to debug a bug, find the root cause, or fix a failing scenario.
Steps
1. Reproduce — Run or describe steps to reproduce; capture error message and stack if any. 2. Isolate — Narrow to the smallest repro (single request, single file, single branch). 3. Hypothesize — List 2–3 likely causes (e.g. null input, wrong config, race). 4. Verify — Add a log, assertion, or minimal test to confirm one cause. 5. Fix — Apply minimal code change; add or update a test to prevent regression. 6. 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.
Related skills
Azure DiagnosticsSystematically diagnose and resolve production issues on Microsoft Azure using official Microsoft guidance.495k1.3kAzure MessagingQuickly diagnose and fix connection, authentication, and message-processing failures when using Azure Event Hubs or Service Bus SDKs.483k1.3k
Diagnosing BugsGet a systematic, step-by-step process that surfaces the real root cause instead of guessing at bugs.291k200k
Use My BrowserWhen their agent task requires access to the live browser session, rendered DOM state, authenticated dashboards, localhost apps, or DevTools-selected elements instea269k71
Systematic DebuggingFollow a repeatable four-phase process that forces root-cause discovery before any code changes.210k265k
Safe DebugGet conservative, non-destructive diagnosis of deep learning and agent errors before any code changes are made.185k512