debug-issue
starsforks
How to install debug-issue?
girijashankarj/cursor-handbook/debug-issue
$npx -y skills add girijashankarj/cursor-handbook --skill debug-issueStructured 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.md
| 1 | # Skill: Debug issue |
| 2 | |
| 3 | ## Trigger |
| 4 | When the user asks to debug a bug, find the root cause, or fix a failing scenario. |
| 5 | |
| 6 | ## Steps |
| 7 | |
| 8 | 1. **Reproduce** — Run or describe steps to reproduce; capture error message and stack if any. |
| 9 | 2. **Isolate** — Narrow to the smallest repro (single request, single file, single branch). |
| 10 | 3. **Hypothesize** — List 2–3 likely causes (e.g. null input, wrong config, race). |
| 11 | 4. **Verify** — Add a log, assertion, or minimal test to confirm one cause. |
| 12 | 5. **Fix** — Apply minimal code change; add or update a test to prevent regression. |
| 13 | 6. **Confirm** — Run type-check and relevant tests. |
| 14 | |
| 15 | ## Rules |
| 16 | - Do not change unrelated code. |
| 17 | - Prefer adding a test that fails before the fix and passes after. |
People who liked this also viewed
6 picksType
- azure-diagnosticsDebug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe triage. WHEN: debug production issues, troubleshoot app service, app service high CPU, app service deploySkillsJul 2026
- systematic-debuggingUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesSkillsJul 2026
- safe-debugRigor Debug / Rigor Audit skill for deep learning research work. Use when the user pastes a traceback, terminal error, CUDA OOM, checkpoint load failure, shape mismatch, NaN loss symptom, or training SkillsMay 2026
- explore-runRigor Improve / Rigor Explore run leaf skill for bounded exploratory evidence in deep learning research repositories. Use when the researcher explicitly authorizes exploratory runs such as small-subseSkillsMay 2026
- minimal-run-and-auditRigor Run skill for README-first deep learning repo reproduction. Use when the task is specifically to capture or normalize evidence from the selected smoke test or documented inference or evaluation SkillsMay 2026
- insforge-debugUse when diagnosing problems in an InsForge project — reactive failures (SDK error object, HTTP 4xx/5xx, gateway timeout 502/503/504, edge function failure or timeout, login/OAuth/auth errors, RLS denSkillsJul 2026
