Adds a new skill at .github/skills/debugging-workflows to guide agents on debugging agentic workflows.

Contents

• Log download scripts - gh aw logs with filtering (date, engine, branch, firewall)
• Run audit scripts - gh aw audit for single-run investigation with URL/job/step support
• Workflow architecture docs - Execution flow, key components, compilation process
• Common issue solutions - Missing tools, permissions, safe-inputs/outputs, network, timeouts
• Advanced techniques - Polling in-progress runs, MCP inspection, firewall analysis
• Reference command tables - Quick lookup for all debugging commands

Example usage

# Download logs from last week
gh aw logs --start-date -1w -o /tmp/debug-logs

# Audit a specific run
gh aw audit https://github.com/owner/repo/actions/runs/1234567890 --json

# Inspect MCP configuration
gh aw mcp inspect <workflow-name>

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.