Claude Code Plugins

Community-maintained marketplace

Feedback

Systematic debugging with structured reproduction and root cause analysis.

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name debug
description Systematic debugging with structured reproduction and root cause analysis.
last_updated Sat Dec 20 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Debug Skill

Overview

Don't guess; verify. This skill guides you through the systematic process of identifying, reproducing, and fixing bugs.

When To Use

  • Users report a bug
  • You encounter an unexpected error
  • Tests are failing inexplicably

Instrumentation

# Log usage when using this skill
./scripts/log-skill.sh "debug" "manual" "$$"

What do you want to do?

  1. Reproduce an issueworkflows/reproduce-issue.md
  2. Find Root Causeworkflows/root-cause-analysis.md
  3. Create Bug Reporttemplates/bug-report.template.md
  4. Research Error Messagesreferences/common-errors.md

The Golden Rule of Debugging

"If you haven't reproduced it, you haven't fixed it."

Always implement a reproduction case (test or script) BEFORE attempting a fix. Highly recommended to use the template at docs/templates/repro-script-template.sh and store artifacts in scripts/repro/.

[!NOTE] No top-level debug/ folder exists. Use skills/debug/ for guidance and scripts/repro/ for artifacts.