output-debug-workflow
Debug Output SDK workflow issues. Use when user reports a workflow failing, erroring, hanging, producing wrong results, or asks to debug, troubleshoot, or investigate a workflow execution.
Install
With your agent
Install OMGSkills skill "growthxai/output:coding_assistants/claude/plugins/outputai/skills/output-debug-workflow" into this agent's normal skills directory: call the OMGSkills MCP get_install_plan tool for your agent and run the script it returns (it installs only the pinned commit and verifies SKILL.md), and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.
Manual command
git clone https://github.com/growthxai/output /tmp/output && ln -s /tmp/output/coding_assistants/claude/plugins/outputai/skills/output-debug-workflow ~/.claude/skills/output-debug-workflowFrom README
Debugging Process Overview Follow a systematic approach to identify and resolve workflow execution issues: verify infrastructure, gather evidence, analyze traces, and apply targeted fixes. EXECUTE: Claude Skill: output-meta-pre-flight Step 1: Verify Services Running Before debugging, confirm that all required services are operational. The output-services-check skill provides comprehensive guidance. IF dockernotrunning: RUN: docker compose up -d WAIT: for services to start (30-60 seconds) IF outputdevnotrunning: RUN: npx output dev WAIT: for services to initialize IF allservicesrunning: PROCEED: to step 2 Expected State: Docker containers for output are running API server responds at http://localhost:3001 Temporal UI accessible at http://localhost:8080 Step 2: List Workflow Runs Identify the failing workflow execution by listing recent runs. The output-workflow-runs-list skill provides detailed filtering guidance.
More from this repo
output-build-workflow
Implement an Output SDK workflow from a plan document.
output-credentials-edit
View, edit, and set encrypted credentials in an Output.ai project.
output-credentials-env-vars
Wire encrypted credentials to environment variables using the credential: convention.