Agent skill

debug

Systematic debugging with structured reproduction and root cause analysis.

View SKILL.md on GitHub Repository
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?

  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.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

salavender/antigravity-compound-engineering-plugin

session-resume

Resume context from previous session

42 8
Explore
salavender/antigravity-compound-engineering-plugin

compound-docs

Document solved problems for knowledge persistence

42 8
Explore
salavender/antigravity-compound-engineering-plugin

standard-security-auth

Security & Authentication Specialist - Expert in JWT, cookie-based auth, MFA, and generic security patterns

42 8
Explore
salavender/antigravity-compound-engineering-plugin

file-todos

Manage file-based todo tracking in the todos/ directory

42 8
Explore
salavender/antigravity-compound-engineering-plugin

mobile

Expertise in mobile responsiveness, specifically table patterns and standard UI component styling.

42 8
Explore
salavender/antigravity-compound-engineering-plugin

react-hooks

Resolves React hook violations (rules of hooks, useEffect dependencies, hook ordering).

42 8
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results