Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add alexj11324/Mikka --skill debug -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/debug/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/debug/

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.

debug official anthropics debug is a Claude Code skill that reproduces errors, traces their causes, and proposes fixes. It starts from an error message, stack trace, or unexpected behavior. CX Codex +1 6,100installs debug jsmastery-pro debug runs a structured investigation loop to find a bug's root cause, applies the minimal fix, and prepares a regression test. CX Codex +1 5,100installs debug Yeachan-Heo debug diagnoses broken OMC sessions, workflow failures, and repo state issues using traces and targeted reproduction. CX Codex +1 705installs debug cyrusagents debug works through a reported bug from reproduction to a minimal fix. Use it when you need to trace an error and verify the result. CX Codex +1 871installs debug parcadei debug is a Claude Code skill that investigates issues through logs, database state, and Git history. It starts during manual testing or implementation when something goes wrong. CX Codex +1 511installs ce-debug EveryInc ce-debug — a skill for Claude Code traces bugs and slow behavior to their cause. It starts when asked to investigate or fix a failure. CX Codex +1 3,700installs debug-like-expert Lex Christopherson debug-like-expert activates a structured debugging protocol for complex issues when standard troubleshooting fails. Gathers evidence, tests hypotheses, and finds root causes instead of applying quick fixes. CX Codex +1 ★ 1,988repo stars debug-systematic travisjneuman debug-systematic — a four-phase debugging skill for hard-to-reproduce failures, race conditions, and unexplained behavior. It guides the agent from reproduction to verified fix. CX Codex +1 152installs principle-attack-the-premise backnotprop principle-attack-the-premise is a Claude Code skill that tests a shared premise after two or more fixes fail at the same gate. It checks the assumption before another fix is written. CX Codex +1 10,100installs systematic-debugging spencerpauly systematic-debugging enforces a structured debugging workflow on your AI assistant instead of random edits. It helps isolate elusive bugs and verify root causes with evidence. CX Codex +1 604installs gjalla-debug gjalla gjalla-debug — a skill that guides agents to find the root cause of a bug with evidence before proposing a fix. Works with Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode. CX Codex +1 357installs

From the same set47

The whole set →
settings-pages settings-pages is a Claude Code skill that guides the layout of account, workspace, and team preferences. It applies when structuring multi-section forms and irreversible actions. CX Codex +1 ★ 88repo stars mikka-action-coverage mikka-action-coverage is a Claude Code skill that audits whether business operations are reachable in the UI and whether controls produce saved changes. Run it when a control is missing, inert, or reports success without a lasting result. CX Codex +1 ★ 88repo stars mikka-ux-quality-audit mikka-ux-quality-audit is a Claude Code skill that executes UI and functional quality sweeps across Mikka. Evaluates permission parity, dead controls, and screen-reader semantics. CX Codex +1 ★ 88repo stars writing-beats writing-beats is a Claude Code skill that shapes a raw-material file into an article, one selected beat at a time. The user chooses the opening and each next direction. CX Codex +1 ★ 88repo stars writing-shape writing-shape is a Claude Code skill that turns raw notes into an article through a step-by-step writing session. The author chooses the opening and builds the piece one block at a time. CX Codex +1 ★ 88repo stars software-factory software-factory is a Claude Code skill that establishes a strict architectural vocabulary for agentic coding factories. Organizes services into slots and breaks workflows into isolated task runs. CX Codex +1 ★ 88repo stars node-ops node-ops is a Claude Code skill for operating Node.js apps in production. It covers deployment questions, process shutdown, health checks, and memory leaks. CX Codex +1 ★ 88repo stars incident incident is a Claude Code skill that guides engineers through production outages. Activates when systems fail, alert thresholds trigger, or during post-mortem reviews. CX Codex +1 ★ 88repo stars

Project sponsors

Companies that keep this analytics open