debug

Organize end-to-end debugging sessions with a phase-driven protocol and diagnostic modes.

Updated Feb 8, 2026
One-click install
npx skills add https://github.com/idealic-ai/engine --skill debug-idealic-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/idealic-ai/engine/tree/main/skills/debug
Command: npx skills add https://github.com/idealic-ai/engine --skill debug-idealic-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

The Skill provides a structured, phase-driven framework to orchestrate end-to-end debugging sessions, ensuring repeatable workflows, thorough triage, and auditable outcomes across complex software issues.

Core Features & Use Cases

  • Phase-based workflow with Setup, Context Ingestion, Triage, Planning, Debug Loop, and Debrief to guide every diagnostic step.
  • Mode-driven triage and walk-throughs (Test Failures, Behavior, Performance, Custom) with reusable templates to standardize investigation and reporting.
  • Automated plan generation and debrief artifact production to ensure clear communication and traceability.

Quick Start

Start a debugging session by selecting a mode (Test Failures, Behavior, Performance, or Custom) to guide a phase-driven triage, planning, and debrief workflow.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I structure a debugging session for complex software issues?

Structure a debugging session using a phase-driven protocol with Setup, Context Ingestion, Triage, Planning, Debug Loop, and Debrief phases to ensure repeatable workflows and thorough diagnostics across complex software issues.

What is the best way to triage test failures, behavior issues, and performance problems?

Triage test failures, behavior issues, and performance problems using mode-driven walk-throughs with reusable templates to standardize investigation, planning, and verification across different diagnostic scenarios.

Can I automate debugging plan generation and artifact production?

Yes, automate debugging plan generation and debrief artifact production to ensure clear communication, traceability, and auditable outcomes throughout the diagnostic workflow.

How do I start a debugging session when I need to diagnose a software issue?

Start a debugging session by selecting a diagnostic mode—Test Failures, Behavior, Performance, or Custom—to guide phase-driven triage, planning, and debrief workflow tailored to the specific issue.

Do I need any specific dependencies to run a protocol-driven debugging workflow?

No specific dependencies are required to run a protocol-driven debugging workflow; the skill relies on frontmatter-defined identity plus optional assets and templates to load context and generate plans.

When should I use a custom diagnostic mode for software triage?

Use a custom diagnostic mode for software triage when standard modes like Test Failures, Behavior, or Performance do not fit the specific issue, allowing mode-specific topics and templates to structure the investigation.