gh-fix-ci

Automate fixing failing GitHub Actions CI checks by inspecting logs, applying changes, and committing them.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/graysurf/agent-kit --skill gh-fix-ci-graysurf
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gh-fix-ci
Source: https://github.com/graysurf/agent-kit/tree/main/skills/automation/gh-fix-ci
Command: npx skills add https://github.com/graysurf/agent-kit --skill gh-fix-ci-graysurf

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automatically diagnoses, fixes, and commits code changes to resolve failing GitHub Actions CI checks, iterating until the pipeline passes.

Core Features & Use Cases

  • Automated CI Debugging: Inspects failing CI checks, extracts relevant log snippets, and attempts to apply fixes.
  • Commit & Push: Uses semantic commit conventions to stage, commit, and push fixes.
  • Iterative Improvement: Watches CI results and repeats the fix-commit-push cycle until all required checks pass.
  • Use Case: A pull request fails its CI checks. Instead of manually debugging, you run this Skill, which identifies the error, suggests a fix, commits it, and pushes the changes, automatically re-running CI until it passes.

Quick Start

Use the gh-fix-ci skill to automatically fix the failing CI checks for pull request number 123.

Frequently Asked Questions about gh-fix-ci

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

FAQPage Schema
How do I automatically fix failing GitHub Actions CI checks?▼

Automating GitHub Actions CI fixes involves inspecting failing logs, applying code changes, and committing them to the branch. This Skill iterates through the fix-commit-push cycle until all required CI pipelines return to a green state.

What is the best way to debug and resolve failing CI pipelines on a pull request?▼

The best way to debug failing CI pipelines on a pull request is to automate the extraction of relevant log snippets and apply fixes iteratively. This Skill identifies the error, commits the fix using semantic conventions, and pushes the changes to automatically re-run CI until it passes.

Do I need to install specific tools to automate fixing GitHub CI checks?▼

Yes, automating GitHub CI fixes requires git, gh, python3, semantic-commit, and git-scope to be installed in your environment. These dependencies provide the necessary command-line functionality to inspect logs, stage, commit, and push the automated code fixes.

Can I use this automated CI debugging approach on specific branches or only pull requests?▼

You can use this automated CI debugging approach on both pull requests and specified branches or commits. It inspects the failing GitHub Actions checks for the given reference, applies the necessary code fixes, and pushes the changes until the pipeline passes.

Why does automating GitHub Actions fixes require semantic-commit conventions?▼

Automating GitHub Actions fixes uses semantic-commit conventions to ensure that the automated code changes are properly staged, committed, and pushed with clear, structured messages. This maintains a clean project history while iterating through the fix-commit-push cycle.

What happens if the automated CI fix does not make the pipeline pass on the first attempt?▼

If the automated CI fix does not make the pipeline pass on the first attempt, the Skill iterates by watching the CI results and repeating the fix-commit-push cycle. It continues to diagnose logs and apply code changes until all required checks pass.