debug

Perform symptom-driven root-cause analysis for AI workflow failures.

24|3|Updated Apr 22, 2026
One-click install
npx skills add https://github.com/HypoxanthineOvO/Hypo-Workflow --skill debug-hypoxanthineovo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/HypoxanthineOvO/Hypo-Workflow/tree/main/skills/debug
Command: npx skills add https://github.com/HypoxanthineOvO/Hypo-Workflow --skill debug-hypoxanthineovo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Investigate a concrete failure by performing symptom-driven root-cause analysis rather than a preventive audit, enabling precise diagnosis and targeted remediation.

Core Features & Use Cases

  • Guides a structured five-step debugging workflow: collect symptoms, assemble context, generate hypotheses, verify through experiments, and document results.
  • Manages worker separation modes to preserve isolation between reproduction, testing, and implementation tasks.
  • Writes diagnostic findings and decisions to the Analysis ledger and debug logs for traceability.

Quick Start

Start symptom-driven debugging by providing observed failure details and relevant context to initialize the workflow.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I perform root-cause analysis for AI workflow failures?

Root-cause analysis for AI workflow failures uses a structured five-step process: collecting symptoms, assembling context, generating hypotheses, verifying through experiments, and documenting results to ensure precise diagnosis and targeted remediation.

What is symptom-driven debugging and when do I need it?

Symptom-driven debugging investigates concrete failures through multi-step hypothesis generation and experimentation. It is needed when preventive audits are insufficient for AI workflows, requiring precise diagnosis based on observed failure details and relevant context.

How do I start a debug session for an incident response?

Start symptom-driven debugging by providing observed failure details and relevant context to initialize the workflow. This triggers the structured five-step process to generate hypotheses and verify them through experiments across worker-separated environments.

Does this debugging workflow preserve isolation between reproduction and testing environments?

Yes, this debugging workflow manages worker separation modes to preserve isolation between reproduction, testing, and implementation tasks. It applies rigorous safety guards around actions, permissions, and evidence handling across these environments.

How are diagnostic findings and decisions traced during incident response?

Diagnostic findings and decisions are traced by writing them to the Analysis ledger and debug logs. This ledgered reporting ensures full traceability for root-cause analysis and documents the outcomes of verified experiments.

When should I not use symptom-driven debugging for AI workflows?

Symptom-driven debugging should not be used when a preventive audit is sufficient to address AI workflow issues. It is specifically designed for active incident response scenarios requiring multi-step hypothesis generation rather than proactive checks.