gh-fix-ci

Inspect failing GitHub Actions checks and draft a fix plan.

467|42|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/mxyhi/ok-skills --skill gh-fix-ci-mxyhi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gh-fix-ci
Source: https://github.com/mxyhi/ok-skills/tree/main/gh-fix-ci
Command: npx skills add https://github.com/mxyhi/ok-skills --skill gh-fix-ci-mxyhi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, and includes scripts (resource) and agents (resource) components.

What problem does it solve?

This Skill helps you quickly identify and fix issues causing your GitHub Actions checks to fail on pull requests, saving you time and frustration during development.

Core Features & Use Cases

  • Automated Check Inspection: Automatically fetches details of failing GitHub Actions checks.
  • Log Analysis: Extracts relevant log snippets to pinpoint the root cause of failures.
  • Fix Planning: Generates a plan to address the identified issues.
  • Use Case: When a pull request fails its CI checks, use this Skill to automatically analyze the logs, tell you exactly what went wrong, and suggest a concrete plan to fix it.

Quick Start

Use the gh-fix-ci skill to inspect failing GitHub PR checks for the current branch.

Frequently Asked Questions about gh-fix-ci

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

FAQPage Schema
How do I debug failing GitHub Actions checks on a pull request?

To debug failing GitHub Actions checks, this Skill inspects the check statuses for your current branch, fetches relevant logs, summarizes the failure context, and drafts a concrete fix plan.

Why does my GitHub PR check fail and how can I find the root cause?

GitHub PR checks can fail due to build errors or failed tests; this Skill analyzes your GitHub Actions logs to pinpoint the root cause and summarizes the failure context for you.

Do I need the GitHub CLI installed to analyze failing CI checks?

Yes, you need the GitHub CLI installed and authenticated to analyze failing CI checks, because this Skill relies on it to fetch check statuses and extract relevant log snippets.

Can I automatically generate a fix plan for a failing GitHub Actions workflow?

Yes, you can automatically generate a fix plan for a failing GitHub Actions workflow; this Skill scopes analysis to GitHub Actions and drafts a plan to address the identified issues.

What's the best way to troubleshoot GitHub Actions failures without reading all logs?

To troubleshoot GitHub Actions failures without reading all logs, this Skill extracts relevant log snippets, summarizes the failure context, and drafts a fix plan for your pull request.

Does this debugging approach work for CI checks outside of GitHub Actions?

No, this debugging approach does not work for CI checks outside of GitHub Actions, because the analysis is explicitly scoped to GitHub Actions checks on pull requests.