debug

Systematic debugging with structured reproduction and root cause analysis.

Stars 42

Forks 8

Install this agent skill to your Project

npx add-skill https://github.com/salavender/antigravity-compound-engineering-plugin/tree/main/skills/debug

SKILL.md

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

bash

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

What do you want to do?

Reproduce an issue → workflows/reproduce-issue.md
Find Root Cause → workflows/root-cause-analysis.md
Create Bug Report → templates/bug-report.template.md
Research Error Messages → references/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.