How does this skill prevent regression bugs?

The skill follows an 'Iron Law' that mandates writing a reproduction test before applying a fix and requires a fresh verification run with actual output logs before a task is considered finished.

When does the debugging skill automatically activate?

It is triggered automatically by Claude Code whenever keywords like 'bug', 'error', 'crash', 'broken', or 'fix' are used in your instructions.

What is the 4-phase debugging process?

It consists of Phase 1: Investigate (repro & evidence), Phase 2: Analyze (comparison & patterns), Phase 3: Hypothesize (theory & minimal testing), and Phase 4: Fix (test-driven application & verification).

Can I use this for performance issues as well?

Absolutely. The systematic investigation and hypothesis phases are designed to handle unexpected behavior, including performance bottlenecks and build failures.

Does it work with deep architectural errors?

Yes, it includes a specific protocol for tracing bad data backward through the call stack to identify the original source of the error rather than patching the symptom.

Aura Frog: Systematic Debugging

Name: Aura Frog: Systematic Debugging
Author: nguyenthienthanh

bynguyenthienthanh

•

Seguridad y Pruebas

Enforces a rigorous four-phase root cause analysis workflow to identify, reproduce, and permanently fix software defects.

The Debugging skill for Aura Frog transforms Claude Code into a precision diagnostic tool by enforcing a 'no fixes without understanding' philosophy. It guides the AI through a structured four-phase process—Investigate, Analyze, Hypothesize, and Fix—ensuring that the source of an error is identified before any code is modified. By mandating the creation of reproduction tests and strictly requiring post-fix verification, this skill prevents 'band-aid' solutions and regression bugs in professional development environments.

Características Principales

01Anti-pattern detection to block unverified 'quick fixes' and assumptions

02Iron Law verification protocol requiring test output confirmation before marking tasks as complete

03Evidence-based investigation using Grep, Bash, and log analysis

04Mandatory root cause tracing to resolve issues at the source rather than the symptom

05Structured four-phase debugging framework (Investigate, Analyze, Hypothesize, Fix)

063 GitHub stars

Casos de Uso

01Investigating unexpected behavior or performance regressions in existing codebases

02Resolving complex logic errors and cryptic stack traces through deep call stack tracing

03Fixing broken CI/CD pipelines and unit test failures using a TDD-inspired approach

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nguyenthienthanh/aura-frog debugging

For use in Claude.ai and ChatGPT

Download Skill