Agent skill · Testing & QA

systematic-debugging

Use this skill whenever a test fails, a code review surfaces a defect, or a bug is reported, to perform structured root-cause analysis rather than trial-and-error patches. Walks symptom → narrow → reproduce → minimal repro → root cause → fix → regression test. Outputs a debug log entry that feeds into Memory and AUDIT_BUNDLE. Chinese trigger examples: "调试", "找 bug 根因", "系统化调试", "Bug 定位", "test failure 调试", "review 反馈 修复". Do NOT use for stylistic feedback (just fix), do NOT use for known one-line fixes. Success = root cause identified with evidence, fix applied at root cause level, regressio

Bill Blasco95★ · 1 repos on radarProfile →
claude-codeApache-2.0
Install
npx skills add charliehzm/medharness --skill systematic-debugging --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 2
SKILL.md size: 3 KB
Bundled scripts: none
Version: 1.0
Requires: Requires read of code + test logs + runtime traces. Optional integration with tracing / profiling tools.
Path: .claude/skills/systematic-debugging/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 96 · +1 this week
Language: Python
Read our review of the source →

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# Systematic Debugging Stops the "patch the symptom, ship, repeat" anti-pattern. ## The cycle ``` Symptom ↓ narrow (which input class / which code path) Reproducer (smallest input that triggers it) ↓ instrument (log / trace / debugger) Hypothesis (1 falsifiable claim) ↓ test the hypothesis directly Root cause (the WHY behind the WHAT) ↓ fix at root (not symptom) Regression test (locks behavior) ``

More from medharness
All skills →
About this skill
What does the systematic-debugging skill do?

Use this skill whenever a test fails, a code review surfaces a defect, or a bug is reported, to perform structured root-cause analysis rather than trial-and-error patches. Walks symptom → narrow → reproduce → minimal repro → root cause → fix → regression test. Outputs a debug log entry that feeds into Memory and AUDIT_BUNDLE. Chinese trigger examples: "调试", "找 bug 根因", "系统化调试", "Bug 定位", "test failure 调试", "review 反馈 修复". Do NOT use for stylistic feedback (just fix), do NOT use for known one-line fixes. Success = root cause identified with evidence, fix applied at root cause level, regressio

How do I install it?

Run `npx skills add charliehzm/medharness --skill systematic-debugging --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From charliehzm/medharness, a repository with 96 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going