Systematic Debugging

Use when encountering bugs or unexpected behavior. Methodical approach to identify root cause: Reproduce → Isolate → Identify → Fix → Verify.

8 stars 3 forksSoftware Development Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add Freddy-CHEN-ux/00_claude_skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add Freddy-CHEN-ux/00_claude_skills --skill systematic-debugging
Manual install
git clone --depth 1 https://github.com/Freddy-CHEN-ux/00_claude_skills.git /tmp/00_claude_skills
mkdir -p ~/.claude/skills
cp -r /tmp/00_claude_skills/skills/systematic-debugging-01 ~/.claude/skills/systematic-debugging

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Systematic Debugging

## Core Principle

Debug methodically, not randomly. Follow a systematic process to identify and fix the root cause, not just symptoms.

## When to Use This Skill

- Encountering bugs or errors
- Unexpected behavior in application
- Tests failing
- Production issues
- User reports problems
- "It worked yesterday" situations

## The Iron Law

**NEVER "try random things until it works."** That's not debugging, it's luck.

Follow the systematic process:
1. **Reproduce** the bug reliably
2. **Isolate** where the problem occurs
3. **Identify** the root cause
4. **Fix** the root cause (not symptoms)
5. **Verify** the fix works and doesn't break anything else

## Why Systematic Debugging?

**Benefits:**
✅ Finds root cause, not symptoms
✅ Prevents same bug from recurring
✅ Builds understanding of the system
✅ Saves time in the long run
✅ Creates better fixes

**Random debugging:**
❌ Fixes symptoms, not causes
❌ Creates new bugs
❌ Wastes time on guesses
❌ No learning
❌ Bug comes back later

## The 5-Step Debugging Process

### Step 1: REPRODUCE

**Goal**: Get the bug to happen consistently
Read the full skill on GitHub

Details

Skill name
systematic-debugging
Path
skills/systematic-debugging-01/SKILL.md
Repo updated
10 January 2026

FAQ

What does the Systematic Debugging skill do?

Use when encountering bugs or unexpected behavior. Methodical approach to identify root cause: Reproduce → Isolate → Identify → Fix → Verify.

How do I install the Systematic Debugging skill?

Claude Code plugin: /plugin marketplace add Freddy-CHEN-ux/00_claude_skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Systematic Debugging popular?

It lives in Freddy-CHEN-ux/00_claude_skills, which has 8 GitHub stars and 3 forks.

Related skills

Add Integration

8

Freddy-CHEN-ux/00_claude_skills

Build a new API integration for Nexus. Load when user mentions "add integration", "new integration", "integrate with", "connect to [service]", or "build [service] integration". Interactive workflow that discovers API endpoints, plans the integration, and creates a project for implementation.

Software Development

AI Agents

8

Freddy-CHEN-ux/00_claude_skills

Production-grade AI agent patterns with MCP integration, agentic RAG, handoff orchestration, multi-layer guardrails, and observability (modern best practices)

AI, LLMs & Agents

AI LLM

8

Freddy-CHEN-ux/00_claude_skills

Production LLM engineering skill. Covers strategy selection (prompting vs RAG vs fine-tuning), dataset design, PEFT/LoRA, evaluation workflows, deployment handoff to inference serving, and lifecycle operations with cost/safety controls.

AI, LLMs & Agents

Systematic Debugging

8

Freddy-CHEN-ux/00_claude_skills

Use for ANY bug, test failure, or unexpected behavior. Use BEFORE proposing fixes. Four phases: investigate, analyze, hypothesize, implement. Ensures understanding before attempting solutions.

Software Development

Software Mobile

8

Freddy-CHEN-ux/00_claude_skills

Production-grade mobile app development with Swift (iOS), Kotlin (Android), React Native, and WebView patterns, including UI/UX, navigation, state management, networking, local storage, push notifications, and App Store deployment.

Software Development

Test Driven Development

8

Freddy-CHEN-ux/00_claude_skills

Use when adding features or fixing bugs. Follow RED/GREEN/REFACTOR cycle. Write failing test first, implement minimal code to pass, then refactor.

Software Development

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.