Skill: Debug issue

SkillDev tools

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.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Skill: Debug issue skill

What this skill tells your AI

The instructions your AI receives, as published by girijashankarj/cursor-handbook in .cursor/skills/backend/debug-issue/SKILL.md and read by ahel’s review.

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.

Signals

GitHub stars
30
Forks
3
Last commit
Aug 2026
Advanced
Catalog kind
skill
Gateway key
debug-issue-girijashankarj
Source
github.com/girijashankarj/cursor-handbook