← ClaudeAtlas

gh-fix-cilisted

Diagnose failing GitHub Actions checks on a PR via gh, summarize the failure context, propose a plan, and only implement after explicit user approval. External CI providers (Buildkite, CircleCI, etc.) are reported by URL only.
ulises-jeremias/agent-toolkit · ★ 14 · AI & Automation · score 79
Install: claude install-skill ulises-jeremias/agent-toolkit
# Fix Failing PR Checks Inspect failing GitHub Actions checks on a PR with `gh`, fetch run logs, extract a focused failure snippet, and propose a fix plan before making any change. ## When to use - A PR has red checks and the user asks to "fix CI", "debug the failing job", or "why is the build red". - You need a fast triage of which jobs failed and the relevant log slice. ## Prerequisites - `gh` installed and authenticated (`gh auth status` exits 0). `doctor` reports this under Integrations. - `python3` for the bundled analyzer. - The current directory is inside the target Git repository (or pass `--repo`). ## Workflow 1. **Verify auth.** `gh auth status`. If unauthenticated, ask the user to run `gh auth login` (repo + workflow scopes typically required). 2. **Resolve the PR.** Defaults to the current branch's PR, or pass `--pr`. 3. **Run the analyzer:** ```bash python3 ~/.local/share/agent-toolkit/skills/gh-fix-ci/scripts/inspect_pr_checks.py \ --repo . --pr <number-or-url> ``` - Add `--json` for machine-friendly output suitable for further processing. - Add `--max-lines <n>` / `--context <n>` to widen the snippet window. The script handles `gh pr checks` field drift, falls back to job-level logs when run-level logs are not yet available, and exits non-zero when failures remain (so it composes in CI / scripts). 4. **Scope external providers.** Any check whose `detailsUrl` is not a GitHub Actions run is reported as `external` w