gh-fix-ci · davila7 — Claude Code skill: what it does, how to install
Finds failing GitHub Actions checks on pull requests, extracts error logs, and prepares a code fix plan. Useful when CI breaks right before a merge.
npx claude-code-templates@latest --skill development/gh-fix-ciWhat gh-fix-ci does
The skill handles broken pull request checks on GitHub. Using the gh CLI tool and a bundled Python script scripts/inspect_pr_checks.py, it inspects CI statuses, pulls logs from failing runs, and extracts relevant error context. External CI tools like Buildkite remain out of scope; the agent only reports their details link.
Drafting the fix relies on the plan skill. The agent never edits code unprompted. It prepares a step-by-step proposal and applies changes only after direct user approval.
Without a logged-in gh client granting workflow and repo scopes, the skill fails immediately. In restricted sandboxes, running gh auth status requires sandbox_permissions=require_escalated so the tool can reach credentials.
What it helps with
- inspect failing GitHub Actions workflows on a pull request
- extract relevant log snippets from broken CI steps
- prepare an actionable fix plan using the plan skill
- apply targeted code updates after manual plan approval
Example prompts for the agent
- Check failing CI runs on my current PR and suggest fixes
- Inspect logs for PR 123 and create a fix plan
- Run scripts/inspect_pr_checks.py for this branch to summarize errors
How to install gh-fix-ci
1claude-code-templates
npx claude-code-templates@latest --skill development/gh-fix-ci2Skills CLI (Vercel)
npx skills add davila7/claude-code-templates --skill gh-fix-ci -a claude-code3Manually: put the files in place
~/.claude/skills/gh-fix-ci/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/gh-fix-ci/
Manually: put the files in place
.agents/skills/gh-fix-ci/SKILL.mdFor all projects use ~/.agents/skills/
Manually: put the files in place
.cursor/skills/gh-fix-ci/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install davila7/claude-code-templates gh-fix-ci2Manually: put the files in place
.github/skills/gh-fix-ci/SKILL.mdPlatform CLI
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/development/gh-fix-ciManually: put the files in place
.devin/skills/gh-fix-ci/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about gh-fix-ci
How to install gh-fix-ci in Claude Code?
Run npx claude-code-templates@latest --skill development/gh-fix-ci in your terminal.
What does gh-fix-ci do?
It inspects failing GitHub Actions jobs on your pull request, pulls failure snippets from job logs, and formulates a repair plan. Once approved, it implements the fixes directly in your code.
Does gh-fix-ci support external CI systems like Buildkite?
No, log fetching and automatic troubleshooting only apply to native GitHub Actions. For external check runs, it only prints the target URL.
Similar skills
All skills for Git and GitHub →gh-fix-ci by other authors comes first.