debug

Classify Forge project failures and produce root-cause summaries with fix guidance.

4|1|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/reliant-labs/forge --skill debug-reliant-labs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/reliant-labs/forge/tree/main/internal/templates/project/skills/forge/debug
Command: npx skills add https://github.com/reliant-labs/forge --skill debug-reliant-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debug methodology helps you quickly classify a failure, run focused investigations in parallel, and produce a clear root-cause handoff without wasting time guessing.

Core Features & Use Cases

  • Triage first to choose the right debugging path (crash, wrong behavior, multi-service issues, flaky tests, or stale generated code).
  • Parallel investigation with track-specific outputs (research hypotheses, isolate with tests, and reproduce with runtime evidence).
  • Synthesis for implementation-ready guidance including root-cause confidence, supporting evidence, and a recommended fix approach.

Quick Start

Tell your agent to debug the failing service by running Forge in debug mode, collecting runtime evidence, and then summarizing a handoff with root-cause confidence and recommended fix steps.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I debug a crash or wrong behavior in a Forge project?

Debugging Forge project failures requires triaging the issue first to choose the right path, then running parallel investigations with runtime evidence to produce a root-cause summary and recommended fix.

What is the best way to triage flaky tests in multi-service flows?

Triage flaky tests and multi-service issues by classifying the failure type, generating research hypotheses, isolating with tests, reproducing with runtime evidence, and synthesizing a root-cause summary with confidence and fix guidance.

Can I investigate stale generated code issues using this debugging methodology?

Yes, the debugging methodology directly applies to stale generated code in Forge-driven development by directing triage, parallel investigation with runtime evidence collection, and evidence-based synthesis for implementer-ready fix guidance.

How do I reproduce a multi-service flow failure to find the root cause?

Reproduce multi-service flow failures by running focused parallel investigations with track-specific outputs, collecting runtime evidence via e2e reproduction, and synthesizing findings into a root-cause summary with confidence and recommended fix steps.

Does this debugging approach work with Delve and Grafana for observability?

The debugging methodology leverages Delve and Grafana for observability to collect runtime evidence during parallel investigation tracks, supporting evidence-based root-cause synthesis across crashes, wrong behavior, and flaky test scenarios.