Find failing PR checks, inspect logs or external check links, and apply focused fixes
Fix CI is a compact workflow skill for getting a failing pull request back to green checks quickly and iteratively. It triggers when a branch or PR has failing CI and provides a tight loop: resolve the active PR, inspect its checks with `gh pr checks`, find the first actionable error from GitHub Actions logs or an external check link, apply the smallest safe fix, push, re-check, and repeat until all checks pass.
The skill is deliberately minimal — a single SKILL.md with no scripts. Its value is procedural discipline: it fixes one actionable failure at a time, prefers minimal low-risk changes over broad refactors, and treats `gh pr checks` as the single source of truth for overall CI state. Its defined output is the primary failing job and root error, the fixes applied in iteration order, and the current CI status with the next action, keeping the developer oriented across iterations.
Target users are developers and platform engineers who use GitHub PRs and the `gh` CLI and want a fast, methodical path from red to green CI without over-engineering fixes. It is a thin, guidance-only catalogue entry rather than a heavy toolkit, best suited to routine CI triage.
Just a SKILL.md describing a trigger, a four-step workflow, guardrails, and an output format. There are no bundled scripts — it is procedural guidance for the agent.
The GitHub CLI (`gh`), specifically `gh pr checks` to enumerate check state and identify failing jobs, plus GitHub Actions logs or external check links to find the root error.
It fixes one actionable failure at a time, extracting the first actionable error and applying the smallest safe change, preferring minimal low-risk edits before any broader refactor.
It re-checks the PR check set after each push and repeats until the checks are green, keeping `gh pr checks` as the source of truth for overall CI state.
Quick Setup:
.claude/skills/Repository
cursor/plugins