Debug Skill

SkillDev tools

Systematic debugging with structured reproduction and root cause analysis.

Available today. Use it from your connected AI after setup.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the Debug Skill skill

What this skill tells your AI

The instructions your AI receives, as published by salavender/antigravity-compound-engineering-plugin in skills/debug/SKILL.md and read by ahel’s review.

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 issue → workflows/reproduce-issue.md
  2. Find Root Cause → workflows/root-cause-analysis.md
  3. Create Bug Report → templates/bug-report.template.md
  4. 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.

Signals

GitHub stars
48
Forks
7
Last commit
Sep 2026
Hacker News mentions
20
Advanced
Item type
skill
Key
debug-salavender
Source
github.com/salavender/antigravity-compound-engineering-plugin