systematic-debugging

A step-by-step method for finding the real cause of a difficult software bug.

In plain words
What is it for?
Use it to reproduce bugs, isolate the smallest failing case, test one hypothesis, fix the underlying cause, and rerun relevant tests.
Why use it?
It replaces repeated guesses with a reproducible test, a narrowed-down failure, a specific explanation, and verification after the fix.

Skill for Claude CodeCodex

Part of the cc-rpi plugin — 13 skills, 18 commands, 2 hooks shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/juan294/cc-rpi/systematic-debugging
Any agent
npx skills add juan294/cc-rpi --skill systematic-debugging
Clone the repo
git clone --depth 1 https://github.com/juan294/cc-rpi

Made for: Claude Code, Codex.

Or install cc-rpi, the plugin that ships this one along with the rest of its 13 skills, 18 commands, 2 hooks.

Per session 51 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 660 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00051 $0.00660
Opus 5 $0.00026 $0.00330
Sonnet 5 $0.00010 $0.00132
Haiku 4.5 $0.00005 $0.00066

Measured 2d ago against content hash a3beeeef2591, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

systematic-debugging scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

templates/skills/systematic-debugging/SKILL.md · 52 lines

How it starts

The opening of the file, as written. The whole thing — 52 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Systematic Debugging

When stuck, stop guessing. Run the loop. Random edits that "might fix it" waste turns and mask the real cause. For known tool/git/CI failures, check the Error Patterns skill first — this skill is for novel bugs.

The Loop

  1. Reproduce. Get a reliable, minimal repro before changing anything. A bug you cannot reproduce on demand, you cannot confirm fixed. Note the exact command, inputs, and expected-vs-actual.
  2. Isolate. Shrink the surface. Remove inputs, comment out code, halve the data until the smallest thing that still fails remains. git bisect when a regression has a known-good past commit.
  3. Hypothesize. State ONE specific, falsifiable cause: "X is null because Y runs before Z." If you cannot name a mechanism, you are still guessing.
  4. Test the hypothesis. Add a log/breakpoint/assertion that the hypothesis predicts. Observe. Confirm or kill it before touching the fix.
  5. Fix the root cause. Not the symptom. If the fix is "add a null check," ask why it is null — that is usually the real bug.
  6. Verify. Re-run the repro from step 1. Then run the surrounding tests to confirm you broke nothing. A fix unconfirmed against the original repro is not a fix.

Discipline

  • Read the actual error. Full message, full stack trace, top to bottom. The answer is in there more often than not. Don't skim to the first familiar line.
  • One change at a time. Change-everything-and-pray destroys the signal about what actually mattered. Revert failed experiments before the next one.
  • Trust nothing, verify everything. Don't assume which function runs, what a variable holds, or that a dependency is installed. Add the log and look.
  • Bisect over speculation. When a thing used to work, the diff that broke it is findable mechanically. Don't theorize about a regression you can bisect.
  • Question the assumption, not just the code. If reality contradicts your mental model, the model is wrong. Find which assumption is false.

Read the full file on GitHub · 52 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 52 lines · 51 tokens per session scan A a3beeeef2591

Subscribe to this mod's changes

systematic-debugging is a skill published in the GitHub repository juan294/cc-rpi (5 stars, last pushed 13d ago), licensed MIT. It adds 51 tokens to every session and 660 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

claude-md-review

Audit a CLAUDE.md file for the patterns that actually degrade Claude Code's output — vagueness, unnamed files, stale facts, and bloat. Use when asked to review, audit, improve, shrink, or fix a CLAUDE.md, and when a project's results feel inconsistent or Claude keeps rediscovering the same context.

wesammustafa/Claude-Code-Everything-You-Need-to-Know · 69 tokens

best-practices

Searchable knowledge base of 152+ programming best practices across 30+ languages and frameworks. BM25-powered search over curated resources from industry leaders (Google, Airbnb, Uber, Mozilla, Shopify, OWASP).

dereknguyen269/programing-best-practices · 0 tokens

common-exploit-verification

Enforce "No Exploit, No Report" policy with PoC construction standards, false-positive filtering, and evidence collection per vulnerability class across backend, frontend, and mobile. Use when validating security findings, constructing exploit proofs, filtering false positives, or writing pentest findings.

HoangNguyen0403/agent-skills-standard · 61 tokens

JavaScript Tooling

Development tools, linting, and testing for JavaScript projects.

HoangNguyen0403/agent-skills-standard · 18 tokens

common-product-requirements

Standardize PRD discovery and drafting for product scope, user outcomes, requirement IDs, and acceptance criteria. Use when creating PRD, product requirements, feature specification, or acceptance criteria plan.

HoangNguyen0403/agent-skills-standard · 44 tokens

common-security-audit

Probe for hardcoded secrets, injection surfaces, unguarded routes, business logic flaws, and platform-specific weaknesses across backend (Node, Go, Java, Python, Rust), frontend (React, Angular, Vue), and mobile (iOS, Android, Flutter) codebases. Use when performing security audits, vulnerability scans, secrets…

HoangNguyen0403/agent-skills-standard · 77 tokens