gh-fix-cilisted
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