github-fix-ci

Analyzes failing GitHub CI checks and applies fixes to affected files.

1|Updated Aug 24, 2026
One-click install
npx skills add https://github.com/mjun0812/skills --skill github-fix-ci-mjun0812
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-fix-ci
Source: https://github.com/mjun0812/skills/tree/main/skills/github/github-fix-ci
Command: npx skills add https://github.com/mjun0812/skills --skill github-fix-ci-mjun0812

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a pull request's CI checks fail, developers must manually dig through workflow logs, identify the root cause, edit files, and push fixes. This Skill automates that entire loop: it inspects check statuses, retrieves failure logs, classifies errors, applies fixes, and commits the changes. ## Core Features & Use Cases - CI Status Inspection: Uses gh pr checks and gh run view --log-failed to locate failing checks and parse error logs tied to the PR head commit. - Error Classification and Fixing: Categorizes failures as test failures, lint errors, build errors, or type errors, then edits the affected files directly. - Safe Execution Modes: Supports --dry-run for analysis-only reports and --no-commit to skip committing, plus a repository mode when no PR exists. - Use Case: A teammate says "CI is failing on my PR, fix it." The Skill detects the failing lint and test jobs, reads the logs, corrects the offending code, commits with a Conventional Commits message in the PR's language, and pushes. ## Quick Start Ask the AI to check the CI status of the current pull request and automatically fix any failing checks.

Frequently Asked Questions about github-fix-ci

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically fix failing CI checks on a GitHub pull request?

Run the Skill against the PR number or current branch. It fetches check statuses with gh pr checks, retrieves failure logs via gh run view --log-failed, classifies each error, edits the affected files, then commits and pushes the fixes.

How to preview CI failure analysis without changing any files?

Pass the --dry-run flag. The Skill stops after analyzing failures and presenting a fix plan, performing no file edits, commits, or pushes. Use --no-commit instead if you want files fixed but commits skipped.

Does it work when there is no pull request for the branch?

Yes, it falls back to repository mode. It analyzes CI failures and fixes files locally, but skips committing and pushing, leaving you to commit manually after reviewing the changes.

Why does the fix target the wrong workflow run sometimes?

The Skill filters runs by the PR head commit SHA using gh run list --commit, excluding stale runs from older commits. If multiple runs remain, it matches failed check names to workflow names and uses only the latest run.

What types of CI failures can it fix automatically?

It classifies and fixes test failures, lint errors, build errors, and type errors by editing the implicated files. Environment issues like missing secrets or permissions are reported as requiring manual intervention instead.