About fix-ci
Fix CI is a skill for addressing failing branch or PR CI checks through an iterative, low-risk workflow. It identifies actionable errors, applies focused fixes, and rechecks the PR status.
Key features
- 01Inspect active PR checks
- 02Find the first actionable error
- 03Apply minimal fixes one at a time
- 04Recheck CI until green
Use cases
- 01Resolve a failing PR check
- 02Diagnose an error in a CI job
- 03Track CI status after each fix
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ cursor/ plugins --skill fix-ciAfter installing, type/fix-ciin Claude Code to confirm it loaded.
Details
From the project READMEFix CI
Trigger
Branch or PR CI is failing and needs a fast, iterative path to green checks.
Workflow
- Resolve the active PR and inspect
gh pr checks --json name,bucket,state,workflow,link. - Inspect failed jobs and extract the first actionable error. Use GitHub Actions logs when available; otherwise use the check link to identify the failing command or service.
- Apply the smallest safe fix.
- Push, re-check the PR check set, and repeat until green.
Guardrails
- Fix one actionable failure at a time.
- Prefer minimal, low-risk changes before broader refactors.
- Keep
gh pr checksas the source of truth for overall PR CI state.
Output
- Primary failing job and root error
- Fixes applied in iteration order
- Current CI status and next action
Comments
Markdown supported