This is a systematic debugging skill that walks you through the standard process: reproduce, isolate, analyze, fix. It includes a solid table of common error categories (null/undefined, type errors, async issues, race conditions), language-specific debug commands for JavaScript, Python, and Go, and practical patterns like divide-and-conquer and minimal reproduction. The skill activates when you mention bugs, errors, or debugging explicitly. Honestly, this is mostly a reference guide rather than something that fundamentally changes how Claude debugs. The real value is in the structured checklist and error lookup tables if you're stuck on a particular error message or need a methodical approach when you're in the weeds.

skills.sh installs
678
GitHub stars
66
last updated
Jul 14, 2026

Install

$ npx -y skills add charon-fan/agent-playbook --skill debugger --agent claude-code

Installs into .claude/skills of the current project.

Files

Debugger

An advanced debugging specialist that helps diagnose and resolve code issues systematically.

When This Skill Activates

Activates when you:

  • Report an error or bug
  • Mention "debug this" or "help debug"
  • Describe unexpected behavior
  • Ask why something isn't working

Debugging Process

Phase 1: Understand the Problem

  1. Reproduce the issue

    • What are the exact steps to reproduce?
    • What is the expected behavior?
    • What is the actual behavior?
    • What error messages appear?
  2. Gather context

    # Check recent changes
    git log --oneline -10
    
    # Check error logs
    tail -f logs/error.log
    
    # Check environment
    env | grep -i debug
    

Phase 2: Isolate the Issue

  1. Locate the error source

    • Stack trace analysis
    • Error code lookup
    • Log correlation
  2. Narrow down scope

    • Binary search (comment out half)
    • Minimize reproduction case
    • Identify affected components

Phase 3: Analyze the Root Cause

Common Error Categories

Sponsors

Details

Repository
github.com/charon-fan/agent-playbook
Categories
AI & Agent Building, Debugging
First seen
May 16, 2026

More from charon-fan/agent-playbook

All 24
1charon-fan avatarqa-expertcharon-fan/agent-playbookqa expert678skills.sh installs
2aj-geddes avataragile-sprint-planningaj-geddes/useful-ai-promptsPlan and execute effective sprints using Agile methodologies. Define sprint goals, estimate user stories, manage sprint backlog, and facilitate daily standups t677skills.sh installs
3aj-geddes avatarlog-analysisaj-geddes/useful-ai-promptsAnalyze application and system logs to identify errors, patterns, and root causes. Use log aggregation tools and structured logging for effective debugging.674skills.sh installs
4aj-geddes avatarsecurity-compliance-auditaj-geddes/useful-ai-promptsConduct comprehensive security compliance audits for SOC 2, GDPR, HIPAA, PCI-DSS, and ISO 27001. Use when preparing for certification, annual audits, or complia673skills.sh installs
5aj-geddes avatarproject-estimationaj-geddes/useful-ai-promptsEstimate project scope, timeline, and resource requirements using multiple estimation techniques including bottom-up, top-down, and analogous estimation methods670skills.sh installs
6daffy0208 avatar3d-visualizerdaffy0208/ai-dev-standardsExpert in Three.js, 3D graphics, and interactive 3D visualizations670skills.sh installs