fix-ci — Claude Code skill: what it does, how to install
This skill finds failed PR checks, examines logs, and guides small fixes. Use it when branch or pull request CI is failing.
npx skills add cursor/plugins --skill fix-ci -a claude-codeWhat fix-ci does
fix-ci resolves the active pull request and checks its status with gh pr checks. It then investigates the failed job, using GitHub Actions logs where available or the check link to locate the first actionable error. After a change, it returns to the PR checks and repeats the cycle.
The skill handles one actionable failure at a time and favours small, low-risk edits over broad refactoring. gh pr checks remains the source of truth for the PR CI result. It depends on GitHub CLI access to the active PR, so confirm that gh is authenticated before using it.
What it helps with
- locate a failed check in a pull request
- identify the first actionable error in job logs
- trace a failure to its command or service
- recheck CI after applying a focused fix
Example prompts for the agent
- Run fix-ci on the current PR and identify the CI failure.
- Use fix-ci to inspect failed checks and fix the first actionable error.
- Ask fix-ci why CI is failing on this branch.
How to install fix-ci
1Skills CLI (Vercel)
npx skills add cursor/plugins --skill fix-ci -a claude-code2Manually: put the files in place
~/.claude/skills/fix-ci/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/fix-ci/
1Skills CLI (Vercel)
npx skills add cursor/plugins --skill fix-ci -a codex2Manually: put the files in place
.agents/skills/fix-ci/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add cursor/plugins --skill fix-ci -a cursor2Manually: put the files in place
.cursor/skills/fix-ci/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install cursor/plugins fix-ci2Manually: put the files in place
.github/skills/fix-ci/SKILL.md1Skills CLI (Vercel)
npx skills add cursor/plugins --skill fix-ci -a gemini-cli2Platform CLI
gemini skills install https://github.com/cursor/plugins --path cursor-team-kit/skills/fix-ciManually: put the files in place
.devin/skills/fix-ci/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add cursor/plugins --skill fix-ci -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set18
The whole set →Similar
Questions about fix-ci
How do I install fix-ci in Claude Code?
Run npx skills add cursor/plugins --skill fix-ci -a claude-code, then run npx skills add cursor/plugins --skill fix-ci -a claude-code again. The skill file is located at ~/.claude/skills/fix-ci/SKILL.md.
What does fix-ci do?
It checks the active PR, investigates failed jobs, and finds the first error that can be addressed. It then tracks the next CI check after a focused change.
What does fix-ci need to inspect a PR?
The skill uses gh pr checks to read overall PR CI status. It needs an active PR and GitHub CLI access to its checks.