debug

Diagnose persistent failures and isolate root causes in software debugging workflows.

Updated Apr 24, 2026
One-click install
npx skills add https://github.com/brianonieal/Syntaris --skill debug-brianonieal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/brianonieal/Syntaris/tree/main/.claude/skills/debug
Command: npx skills add https://github.com/brianonieal/Syntaris --skill debug-brianonieal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you diagnose persistent failures methodically when repeated fixes have not worked, so you can stop guessing and identify the real cause.

Core Features & Use Cases

  • Structured Root Cause Analysis: Gathers the symptom, expected behavior, actual behavior, and trigger point before proposing any fix.
  • Circuit-Breaker Workflow: Activates after three consecutive failures on the same problem or when the user explicitly requests /debug.
  • Subagent Delegation: Offloads heavy investigation to an isolated debug agent that checks prior errors, searches the codebase, and forms a confidence-rated diagnosis.
  • Verification Before Repair: Requires diagnosis review, user approval, test execution, and regression checks before considering the issue resolved.

Quick Start

Ask the AI to run the debug protocol on the current failure and return a root-cause diagnosis with the most likely fix.

Frequently Asked Questions about debug

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find the root cause of a persistent software failure after repeated fixes?

Root cause analysis for persistent failures requires gathering symptoms, expected behavior, actual behavior, and trigger points before proposing a fix. This approach stops repeated guessing by verifying findings against prior errors, relevant files, and test outcomes to isolate the true cause.

What is a circuit breaker workflow in software debugging?

A circuit breaker workflow in debugging activates an isolated investigation process after three consecutive failures on the same problem. It stops repeated guessing by offloading heavy codebase investigation, checking prior errors, and forming a confidence-rated diagnosis before any repair.

How do I systematically debug recurring code errors instead of guessing?

Systematically debug recurring errors by gathering symptoms and trigger points, searching the codebase, and verifying findings against test outcomes. This methodical failure diagnostics process requires user approval, test execution, and regression checks before considering the issue resolved.

When should I use a subagent for error diagnostics instead of manual troubleshooting?

Use a subagent for error diagnostics when persistent failures require heavy codebase investigation. An isolated debug agent checks prior errors, searches relevant files, and forms a confidence-rated triage, ensuring you verify findings before recommending a fix rather than guessing.

Does this debugging method work without writing new tests first?

This debugging method requires test execution and regression checks before considering an issue resolved. It verifies the confidence-rated diagnosis against existing test outcomes and relevant files, ensuring the recommended fix addresses the actual root cause without introducing new failures.