Debugging
Find and fix bugs systematically with David Agans's "Debugging — The 9 Indispensable Rules" (2002) and Andreas Zeller's "Why Programs Fail" (2nd ed. 2009), led by a feedback-loop-first discipline — no theory until one fast, deterministic command goes red on this exact bug. Covers the defect → infection → failure chain, Zeller's TRAFFIC procedure and scientific method (falsifiable hypotheses, a debugging log), Agans's nine rules (make it fail, quit thinking and look, divide and conquer, change one thing at a time, check the plug, if you didn't fix it it ain't fixed), minimising repros, delta de
Install
/plugin marketplace add vnovakovits/claude-skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add vnovakovits/claude-skills --skill debugginggit clone --depth 1 https://github.com/vnovakovits/claude-skills.git /tmp/claude-skills
mkdir -p ~/.claude/skills
cp -r /tmp/claude-skills/plugins/engineering-practices/skills/debugging ~/.claude/skills/debuggingPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Debugging (David Agans, Andreas Zeller) Apply this skill whenever something is broken and the cause isn't obvious at first glance: a wrong result, an exception, a failing or flaky test, a slowdown, a bug that only happens in one environment. It combines two complementary books. Agans gives nine rules of conduct that keep a debugger honest; Zeller gives the theory and the systematic techniques (the infection chain, the scientific method, delta debugging). On top of both sits one rule that decides most debugging sessions: **build the feedback loop first**. ## Core Philosophy **No loop, no theory.** If you have a fast, deterministic command that goes red on *this* bug, you will find the cause: bisection, hypotheses and instrumentation all just consume that signal. Without one, no amount of reading code will save you. Spend disproportionate effort on the loop. Most failed debugging sessions are sessions that started theorising before they could make the bug happen on demand. **Quit thinking and look.** (Agans, rule 3.) Bugs live in the gap between what you think the code does and what it does. Reasoning about the code repeats the same assumptions that let the bug in. Observe the actual behaviour: values, timings, the order of events. Guess only to decide where to look next.
Details
- Skill name
debugging- Repository
- vnovakovits/claude-skills
- Path
plugins/engineering-practices/skills/debugging/SKILL.md- License
- MIT
- Repo updated
- 16 November 2026
FAQ
What does the Debugging skill do?
Find and fix bugs systematically with David Agans's "Debugging — The 9 Indispensable Rules" (2002) and Andreas Zeller's "Why Programs Fail" (2nd ed. 2009), led by a feedback-loop-first discipline — no theory until one fast, deterministic command goes red on this exact bug. Covers the defect → infection → failure chain, Zeller's TRAFFIC procedure and scientific method (falsifiable hypotheses, a debugging log), Agans's nine rules (make it fail, quit thinking and look, divide and conquer, change one thing at a time, check the plug, if you didn't fix it it ain't fixed), minimising repros, delta de
How do I install the Debugging skill?
Claude Code plugin: /plugin marketplace add vnovakovits/claude-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Debugging popular?
It lives in vnovakovits/claude-skills, which has 5 GitHub stars and 2 forks.
Related skills
Accidental Cio
5vnovakovits/claude-skills
Apply Scott Millett's "The Accidental CIO — A Lean and Agile Playbook for IT Leaders" (Wiley, 2024) when designing or reviewing how a technology organisation decides, funds, governs and delivers work. Covers the five components of an adaptive IT operating model (organised, work, govern, talent, lead) and its four themes (outcomes over output, intrinsic motivation, being not doing agile, manage flow not people); matching method and governance to context via Cynefin and Wardley evolution; governance as demand management + funding + measurement + decision rights, shifting from project funding to
Agent Retro
5vnovakovits/claude-skills
Run a retrospective on a coding-agent session and improve the agent's environment, not the code. Combines Derby & Larsen's five-stage retrospective, Shigeo Shingo's poka-yoke (turn a mechanical mistake into a check that makes it impossible), and Matt Pocock's retro categories — navigation, automated checks, coding standards, steering files, tool economy, information access. Covers mining the session transcript for corrections, wrong turns and slow searches; deciding where each fix belongs (analyzer, hook, CI, reviewer standards, CLAUDE.md pointer, skill, doc or memory); the no-op test for stee
API Design
5vnovakovits/claude-skills
Design APIs that are clear, evolvable, and idiomatic to their protocol — covering REST (Fielding, Richardson Maturity Model, Massé), GraphQL, gRPC/protobuf, versioning strategies, pagination, error responses (RFC 7807 Problem Details), idempotency, authentication, documentation (OpenAPI), and the pragmatic trade-offs between RESTful purity and developer ergonomics. Use when designing a new endpoint, choosing between REST/GraphQL/gRPC, defining versioning, structuring error responses, deciding pagination strategy, or evaluating an existing API's evolvability.
Dev API Design
8Freddy-CHEN-ux/00_claude_skills
Production-grade API design patterns for REST, GraphQL, and gRPC. Covers API architecture, OpenAPI/Swagger specs, versioning strategies, authentication flows, rate limiting, pagination, error handling, and documentation best practices for modern API development.
Cupid Properties
5vnovakovits/claude-skills
Apply Dan North's CUPID properties (Composable, Unix philosophy, Predictable, Idiomatic, Domain-based) — a 2022 alternative framing to SOLID, oriented toward "joyful code" and properties to lean toward rather than principles to obey. Use when evaluating code quality, when SOLID feels like a rulebook rather than a guide, or when looking for a complementary lens that emphasizes ergonomics, composability, and fit with the surrounding ecosystem.
Dify Tool Developer
8Freddy-CHEN-ux/00_claude_skills
Guide AI agents through Dify tool plugin development with mandatory documentation loading and direct CLI usage. Use when creating Dify tool plugins or extending Dify with custom tools.
Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.