About fix-ci
fix-ci is a skill for addressing failing branch or pull request CI checks through short, iterative fixes. It inspects failed jobs, applies the smallest safe change, and repeats checks until they pass.
Key features
- 01Inspect pull request check status
- 02Find the first actionable job error
- 03Apply minimal, low-risk fixes
- 04Recheck CI after each change
- 05Report root error, changes, and status
Use cases
- 01Diagnose failing branch CI checks
- 02Iteratively resolve pull request CI failures
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ ericlitman/ open-pstack --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