debug · alexj11324 — Claude Code skill: what it does, how to install
debug is a Claude Code skill that enforces hypothesis-driven debugging. It stops the agent from editing files until the root cause is framed, tested, and confirmed.
AGPL-3.0 ★ 88 updated 2026-11-17
npx skills add alexj11324/Mikka --skill debug -a claude-codeWhat debug does
This skill forces the assistant into a structured investigation routine instead of making random edits. The agent starts by recording expected versus actual behavior, identifying recent codebase changes, and checking reproducibility. It then drafts a falsifiable hypothesis and narrows scope using git bisect, bottom-up stack trace inspection, or minimal reproduction cases.
Code modifications are blocked until the failure is deliberately reproduced through a targeted assertion or log. Fixes must remain minimal and target the underlying cause rather than treating symptoms. Every resolved issue requires an accompanying regression test to prevent recurring defects.
What it helps with
- trace failures to their root cause without guesswork
- isolate breaking commits using
git bisect - write regression tests that verify the fix
- analyze bottom-up stack traces in application code
Example prompts for the agent
- "I am getting an unexpected TypeError in this module, investigate why"
- "The test suite is failing after the latest merge, locate the cause"
- "The checkout calculates the wrong total on discounted carts, find the bug"
How to install debug
1Skills CLI (Vercel)
npx skills add alexj11324/Mikka --skill debug -a claude-code2Manually: put the files in place
~/.claude/skills/debug/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/debug/
1Skills CLI (Vercel)
npx skills add alexj11324/Mikka --skill debug -a codex2Manually: put the files in place
.agents/skills/debug/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add alexj11324/Mikka --skill debug -a cursor2Manually: put the files in place
.cursor/skills/debug/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install alexj11324/Mikka .claude/skills/debug2Manually: put the files in place
.github/skills/debug/SKILL.md1Skills CLI (Vercel)
npx skills add alexj11324/Mikka --skill debug -a gemini-cli2Platform CLI
gemini skills install https://github.com/alexj11324/Mikka --path .claude/skills/debugManually: put the files in place
.devin/skills/debug/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about debug
How to install debug in Claude Code?
Run npx skills add alexj11324/Mikka --skill debug -a claude-code in your terminal.
What does debug do?
It establishes a six-phase debugging protocol covering problem framing, hypothesis formation, scope reduction, verification, root-cause patching, and test creation.
Does the debug skill require writing tests?
Yes, the workflow explicitly mandates a regression test before an issue is considered resolved.
Similar skills
All skills for Testing and QA →debug by other authors comes first.