gh-actions-debug

Diagnose failing GitHub Actions workflows. Speed is critical — minimize tool calls.

Scripts in <skill-dir>/scripts/ handle data fetching. Use them — never write inline bash chains.

Path note: <skill-dir> is the directory containing this SKILL.md. For subagents running from the repo root, prefix with skills/gh-actions-debug/.

Method

1. Identify the run

Parse https://github.com/{owner}/{repo}/actions/runs/{run_id} from the URL. If no URL, use gh run list --limit 5 --status failure --json databaseId,headBranch,workflowName,conclusion,url.

2. Fetch all data (1 bash call)

bash <skill-dir>/scripts/fetch-run.sh {owner} {repo} {run_id} {output_dir}