Agent-Skills.md

Agent Skills: Debugging Expert

Systematic troubleshooting using the Scientific Method. Use when debugging crashes, tracing errors, diagnosing unexpected behavior, or investigating exceptions. (triggers: debug, fix bug, crash, error, exception, troubleshooting)

UncategorizedID: hoangnguyen0403/agent-skills-standard/common-debugging

Repository

hoangnguyen0403/agent-skills-standard
HoangNguyen0403License: Apache-2.0
362103

Install this agent skill to your local

pnpm dlx add-skill https://github.com/HoangNguyen0403/agent-skills-standard/tree/HEAD/.agents/skills/common/common-debugging

Skill Files

Browse the full folder contents for common-debugging.

Download Skill

Loading file tree…

.agents/skills/common/common-debugging/SKILL.md

Skill Metadata

Name
common-debugging
Description
Troubleshoot systematically using the Scientific Method. Use when debugging crashes, tracing errors, diagnosing unexpected behavior, or investigating exceptions.

Debugging Expert

Priority: P1 (OPERATIONAL)

Scientific Method

  1. OBSERVE: Gather data. What exactly happening?
  • Logs, Stack Traces, Screenshots, Steps to Reproduce.
  1. HYPOTHESIZE: Formulate theory. "I think X causing Y because Z."
  2. EXPERIMENT: Test theory.
  • Create reproduction case.
  • Change one variable at time to validate hypothesis.
  1. FIX: Implement solution once root cause proven.
  2. VERIFY: Ensure fix works and doesn't introduce regressions.

Anti-Patterns

  • No shotgun debugging: Prove root cause before changing code.
  • No debug prints in production: Remove all print/console.log before commit.
  • No symptom masking: Fix root cause; never swallow errors without handling.

Best Practices

  • Diff Diagnosis: What changed since it last worked?
  • Minimal Repro: Create smallest possible code snippet that reproduces issue.
  • Rubber Ducking: Explain code line-by-line to inanimate object (or agent).
  • Binary Search: Comment out half code to isolate failing section.

References