workflow-debugger

Diagnose Gorgon workflow failures by inspecting checkpoint states, agent logs, and budget traces.

4|1|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/AreteDriver/ai-skills --skill workflow-debugger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workflow-debugger
Source: https://github.com/AreteDriver/ai-skills/tree/main/agents/analysis/workflow-debugger
Command: npx skills add https://github.com/AreteDriver/ai-skills --skill workflow-debugger

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill pinpoints the exact cause of failures in Gorgon workflows, providing clear evidence and actionable steps to resolve them, saving significant debugging time.

Core Features & Use Cases

  • Root Cause Analysis: Identifies why workflows fail by examining logs, checkpoints, and budget data.
  • Actionable Fixes: Provides prioritized recommendations with effort estimates for resolving issues.
  • Post-Mortem Analysis: Analyzes successful workflows to identify cost and performance optimization opportunities.
  • Use Case: A critical workflow failed mid-execution. Use this Skill to quickly understand if it was a contract violation, budget issue, or external error, and get clear instructions on how to fix it.

Quick Start

Use the workflow debugger to diagnose the failure of workflow run 'run_2026-02-12_001' using the provided checkpoint database and log path.

Frequently Asked Questions about workflow-debugger

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

FAQPage Schema
How do I diagnose a failing Gorgon workflow run?

Workflow debugging identifies why workflows fail by examining logs, checkpoints, and budget data to provide root-cause analysis. It helps determine if failures stem from contract violations, budget issues, or external errors.

Why did my workflow fail mid-execution?

A workflow failing mid-execution can be diagnosed by examining checkpoint states, agent logs, and budget traces. This process determines if the failure was caused by a contract violation, a budget issue, or an external error, providing clear evidence for the root cause.

How do I perform a post-mortem analysis on a successful workflow?

Post-mortem analysis on a successful workflow inspects checkpoint states, agent logs, and budget traces to identify cost and performance optimization opportunities. This analysis yields actionable recommendations for improving future workflow orchestration efficiency.

Can I get actionable fix recommendations for workflow orchestration issues?

Yes, troubleshooting workflow failures provides prioritized, actionable fix recommendations complete with effort estimates. By inspecting checkpoint states and budget traces, you receive clear instructions on how to resolve workflow orchestration issues.

What is the best way to troubleshoot workflow orchestration issues?

The best way to troubleshoot workflow orchestration issues is by analyzing agent logs, checkpoint data, and budget traces. This approach provides root-cause analysis with evidence, distinguishing between contract violations, budget issues, and external errors.

What do I need to debug a Gorgon workflow run?

To debug a Gorgon workflow run, you need the checkpoint database and the agent log path. Providing these inputs allows the debugger to inspect states, logs, and budget traces to generate root-cause analysis and actionable fixes.