debugging-workflows

Syntax errors in workflows typically stem from mismatched brackets, unclosed quotes, or invalid operators. Check the line near the error message for bracket pairs, ensure all strings are properly quoted, and verify operator syntax matches your workflow format. This Skill guides you through isolating and correcting these issues systematically.

Agent invocation failures occur when the referenced agent name is misspelled, doesn't exist in your agents registry, or isn't deployed to the expected location. Verify the agent spelling, check `agents/registry.json` or `temp-agents/` for existence, and confirm the agent is properly registered before workflow execution.

Variable failures happen when variables aren't captured, scoped incorrectly, or referenced before assignment. This Skill helps you trace variable capture points, verify naming consistency across steps, inspect variable state at checkpoints, and confirm proper binding before dependent steps execute.

Effective workflow debugging follows a proven methodology: reproduce the failure, isolate the failing step, inspect error messages and logs, identify the root cause (syntax, agent, or variable issue), apply a fix, and verify the solution works. This Skill guides you through each stage with diagnostic tools and remediation steps.

Yes. This Skill covers diagnostics for parallel execution branches, checkpoint handling, and state verification across concurrent steps. It helps identify synchronization issues, checkpoint failures, and variable state problems that arise in complex multi-branch workflows.

Common workflow error messages include 'unexpected token' (syntax), 'agent not found' (agent registration), 'variable undefined' (binding), and execution timeouts (logic or resource issues). This Skill provides clear interpretation of these messages, their root causes, and actionable remediation for each category.