About fix-ci
A skill for iteratively diagnosing and fixing failing branch or pull request CI. It prioritizes the first actionable error and applies minimal, low-risk changes, using `gh pr checks` to track overall status.
Key features
- 01Inspects pull request check status
- 02Finds the first actionable failure
- 03Applies minimal fixes iteratively
- 04Rechecks CI until green
Use cases
- 01Diagnosing a failed CI job
- 02Fixing a pull request check failure
- 03Tracking CI status after a change
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ michael-denyer/ pstack-claude --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