Back to skills
SkillHub ClubShip Full StackFull StackTesting

debug

Expert debugging methodology. Triggers on debug, investigate, fix bug, troubleshoot.

Packaged view

This page reorganizes the original catalog entry around fit, installability, and workflow context first. The original raw source lives below.

Stars
5
Hot score
82
Updated
March 20, 2026
Overall rating
C1.6
Composite score
1.6
Best-practice grade
B80.4

Install command

npx @skill-hub/cli install sbusso-claude-system-debug

Repository

sbusso/claude-system

Skill path: skills/debug

Expert debugging methodology. Triggers on debug, investigate, fix bug, troubleshoot.

Open repository

Best for

Primary workflow: Ship Full Stack.

Technical facets: Full Stack, Testing.

Target audience: everyone.

License: Unknown.

Original source

Catalog source: SkillHub Club.

Repository owner: sbusso.

This is still a mirrored public skill entry. Review the repository before installing into production workflows.

What it helps with

  • Install debug into Claude Code, Codex CLI, Gemini CLI, or OpenCode workflows
  • Review https://github.com/sbusso/claude-system before adding debug to shared team environments
  • Use debug for development workflows

Works across

Claude CodeCodex CLIGemini CLIOpenCode

Favorites: 0.

Sub-skills: 0.

Aggregator: No.

Original source / Raw SKILL.md

---
name: debug
description: Expert debugging methodology. Triggers on debug, investigate, fix bug, troubleshoot.
---

# Debug Like an Expert

**Core principle:** VERIFY, DON'T ASSUME. Code you wrote deserves extra skepticism.

## Phase 1: EVIDENCE GATHERING
- Document exact error (full message, stack trace)
- Identify affected components
- Check recent changes (`git diff`, `git log`)
- Research error via context7 MCP if needed

**Output:** Evidence summary
**Gate:** Have reproducible steps before proceeding

## Phase 2: ROOT CAUSE ANALYSIS
- Form 2-3 testable hypotheses
- Test ONE variable at a time
- Read complete files, not snippets
- Chase dependencies to their source

**Output:** Identified root cause with evidence
**Gate:** Can explain WHY the bug occurs

## Phase 3: SOLUTION
- Implement minimal fix
- Verify fix addresses root cause (not symptoms)
- Test original reproduction steps
- Check for regressions

**Output:** Working fix with verification

## Rules
- No fixes without explaining WHY they work
- Never assume - verify every assumption
- Test one change at a time
- Would this fix survive code review?
debug | SkillHub