About fix-ci
fix-ci is a workflow skill for developers diagnosing and resolving failing branch or pull request CI. It traces actionable job errors, applies small fixes, and repeats checks until CI is green.
Key features
- 01Inspect pull request checks and job logs
- 02Identify actionable CI failures
- 03Apply minimal, low-risk fixes
- 04Repeat checks until CI is green
- 05Report errors, fixes, and status
Use cases
- 01Diagnose a failing pull request check
- 02Make an iterative fix to a branch CI failure
- 03Summarize the root error and current CI status
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ poteto/ 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