workflow-debug

Validate Claude workflow units against maps and source files.

1|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/0xHarbs/agent-setup --skill workflow-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workflow-debug
Source: https://github.com/0xHarbs/agent-setup/tree/main/claude/skills/automation/workflow-debug
Command: npx skills add https://github.com/0xHarbs/agent-setup --skill workflow-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Fragmented workflow definitions and scattered checks between maps and code cause misconfigurations and undetected errors in Claude workflow execution. This skill provides a unified static and optional live validation workflow to catch inconsistencies before deployment.

Core Features & Use Cases

  • Static verification of workflow maps against source files to ensure entry points, imports, and middleware align with expectations.
  • Live UI testing (optional) to simulate real user interactions for api-route and ui-flow workflows and report regressions.
  • Comprehensive checks including type consistency, DB schema alignment, error handling, env dependencies, and cross-reference integrity.
  • Use cases: audit a set of workflows for security and reliability, verify that changes to maps reflect in code, and generate machine-readable reports for CI.

Quick Start

Run the static verification on all workflows using the workflow-debug command and review the generated reports.

Frequently Asked Questions about workflow-debug

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

FAQPage Schema
How do I validate API route and UI flow workflows against source files?

You can validate API route and UI flow workflows by running static checks on entry points, import chains, and auth middleware against source files. It outputs a structured JSON report and a markdown dossier highlighting inconsistencies.

What is static analysis for workflow maps and why is it needed?

Static analysis for workflow maps verifies that defined workflows align with actual code by checking type compatibility, DB schema alignment, and error handling. It is needed to catch fragmented definitions and undetected misconfigurations before deployment.

Can I run live UI testing to simulate user interactions for workflow debugging?

Yes, live UI testing is an optional feature that simulates real user interactions for API route and UI flow workflows. It reports regressions by validating cross-reference integrity and environment dependencies dynamically.

How do I audit IPC channel workflows for security and reliability issues?

You audit IPC channel workflows by applying comprehensive static checks on cross-reference integrity, environment dependencies, and error handling. This produces a machine-readable JSON report detailing security and reliability gaps.

Does this workflow debugging tool require any specific dependencies to run?

No specific external dependencies are required to run the workflow debugging tool. It operates natively to perform static validation and optional live UI diagnostics directly against your workflow map and source files.

What is the best way to generate machine-readable reports for CI from workflow maps?

The best way to generate CI reports is to run static verification across all workflows to produce a structured JSON report. This output maps entry points, import chains, and schema alignment for automated pipeline integration.