🔍
QualityRust

Systematic Debugging

by xintaofei

Systematic Debugging is a Quality skill for Claude Code, published by xintaofei in codeg.

2.8K stars344 forkson xintaofei/codegAdded 2026/08/17+3% in starsRepository updated 2026/08/17
View source on GitHubDownload repo ZIP
acpagentclaude-codeclinecode-generationcodebuddycodexgemini-cligrok-buildguihermes-agentkimi-codeopenclawopencodepiworktree
Install in seconds
Install Systematic Debugging
Copy Systematic Debugging into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/xintaofei/codeg/tree/main/src-tauri/experts/skills/systematic-debugging ~/.claude/skills/systematic-debugging

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/xintaofei/codeg.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file
src-tauri/experts/skills/systematic-debugging/SKILL.md in xintaofei/codeg
Installs to
~/.claude/skills/systematic-debugging
Collection
One of 25 skills cataloged from this repository
Category
Quality — 1354 skills

What Systematic Debugging does

Systematic Debugging guides a root cause investigation before attempting any fix for bugs, test failures, or unexpected behavior. Use it to avoid symptom fixes and ensure fixes address the underlying issue.

Systematic Debugging is cataloged under Quality on DirSkills. Systematic Debugging comes from a repository tagged acp, agent, claude-code, cline and code-generation.

Documentation

README

Systematic Debugging

Overview

Core principle: ALWAYS find root cause before attempting fixes. Symptom fixes are failure.

Violating the letter of this process is violating the spirit of debugging.

The Iron Law

NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST

If you haven't completed Phase 1, you cannot propose fixes.

When to Use

Use for ANY technical issue:

  • Test failures
  • Bugs in production
  • Unexpected behavior
  • Performance problems
  • Build failures
  • Integration issues

Use this ESPECIALLY when:

  • Under time pressure (emergencies make guessing tempting)
  • "Just one quick fix" seems obvious
  • You've already tried multiple fixes
  • Previous fix didn't work
  • You don't fully understand the issue

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Systematic Debugging

  • What else does xintaofei publish alongside Systematic Debugging?

    Systematic Debugging is one of 25 skills that DirSkills catalogs from xintaofei/codeg, the repository it ships in. Its siblings there include Brainstorming, Citation Management and Code Review Reception. Each one is a separate skill with its own page in this directory, installs the same way Systematic Debugging does, and is maintained by xintaofei in that same repository. The rest of the collection is listed on the xintaofei/codeg page.

  • How does Systematic Debugging compare to other Quality skills?

    Systematic Debugging ranks #487 by stars among the 1354 Quality skills in this catalog. The most-starred ones next to it are Benchmark, Benchmark Optimization Loop and API Design Patterns. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Systematic Debugging against them. Open each page to compare what they document and how they install.

More from xintaofei/codeg

Systematic Debugging is one of 25 skills cataloged on DirSkills from xintaofei/codeg.

See all 25 skills →
💡
2w ago

Brainstorming

Brainstorming turns ideas into fully formed designs and specs through collaborative dialogue, asking clarifying questions and proposing approaches before implementation. Use it before any creative or coding work to align on requirements and get approval.
AI Engineering
2.8K344
📚
2w ago

Citation Management

Citation Management searches Google Scholar and PubMed for papers, extracts accurate metadata, validates citations, and generates properly formatted BibTeX entries. Use it when you need to find papers, verify citation information, convert DOIs to BibTeX, or ensure reference accuracy in scientific writing.
Writing
2.8K345
🧪
2w ago

Code Review Reception

Code Review Reception establishes a verification-first workflow for responding to code review feedback, requiring technical evaluation and clarification before implementation rather than performative agreement. Use it when receiving feedback from humans or external reviewers to avoid blind implementation and ensure changes fit the codebase.
Quality
2.8K344
🤖
2w ago

Dispatching Parallel Agents

Dispatching Parallel Agents delegates independent tasks to multiple concurrent subagents to investigate and fix issues in parallel. Use it when you have 2+ independent tasks that can be worked on without shared state or sequential dependencies.
AI Engineering
2.8K344
📋
2w ago

Executing Plans

Executing Plans loads a written implementation plan, reviews it critically, executes all tasks with verification, and reports when complete. Use it when you have a written implementation plan to execute in a separate session with review checkpoints.
Automation
2.8K344
🧪
2w ago

Experimental Design

Experimental Design plans experiments and studies before data collection, choosing a design, randomizing, blocking, and laying out treatment combinations so results are interpretable. Use it when assigning subjects to groups, screening factors, or setting up factorial or response-surface designs.
Data
2.8K345

More Quality skills

Systematic Debugging is one of 1354 Quality skills cataloged on DirSkills, ranked #487 by stars among them.

Browse all Quality skills →
⏱️
3w ago

Benchmark

Benchmark measures performance baselines, detects regressions before and after PRs, and compares stack alternatives for pages, APIs, and builds.
Quality
239.8K36.4K
⏱️
3w ago

Benchmark Optimization Loop

Benchmark Optimization Loop turns vague performance goals into a bounded, measured optimization process. Use it when asked to make something faster, benchmark latency/throughput/cost, or choose the best implementation by repeated measured tests.
Quality
239.8K36.4K
🔌
3w ago

API Design Patterns

API Design Patterns provides conventions and best practices for designing consistent REST APIs. Use it when creating endpoints, reviewing contracts, handling pagination, error responses, status codes, filtering, or versioning.
Quality
239.8K36.4K