gh-fix-ci

Diagnoses GitHub Actions PR check failures and drafts fix plans from logs.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/peteanderson80/skills --skill gh-fix-ci-peteanderson80
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gh-fix-ci
Source: https://github.com/peteanderson80/skills/tree/main/skills/gh-fix-ci
Command: npx skills add https://github.com/peteanderson80/skills --skill gh-fix-ci-peteanderson80

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Diagnoses and fixes failing GitHub PR checks by extracting actionable failure context from GitHub Actions logs and presenting a concise remediation plan.

Core Features & Use Cases

  • Inspect GitHub Actions PR checks and summarize failure snippets from logs.
  • Draft a focused, approval-ready fix plan and surface the exact changes needed.
  • Integrate with existing plan-based skills when available, ensuring safe, approved implementation.

Quick Start

Run the inspect_pr_checks.py script to fetch failing checks and produce a readable summary for immediate review.

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 fetches PR checks via the gh CLI, retrieves workflow logs, parses JSON outputs, and summarizes failure snippets into a readable, review-friendly remediation plan. It extracts actionable context directly from the logs.

Can I automatically fix failing CI checks without manually reading GitHub Actions logs?

Yes, you can automatically fix failing CI checks by running the inspect_pr_checks.py script. It produces a focused failure summary and a draft fix plan, then optionally implements the exact changes needed after receiving explicit approval.

What do I need to diagnose GitHub PR check failures with this debugging workflow?

To diagnose GitHub PR check failures, you need the gh CLI, git, and python3 installed and configured. These dependencies allow the script to fetch check statuses, retrieve logs, and parse JSON to generate the fix plan.

Does this CI debugging tool work with non-GitHub CI providers like Jenkins or GitLab CI?

No, this CI debugging tool does not work with non-GitHub CI providers. It specifically targets GitHub Actions-based checks on pull requests, using the gh pr checks command to fetch logs and parse failures within the GitHub ecosystem.

What is the best way to get a concise summary of GitHub Actions log failures?

The best way to get a concise summary of GitHub Actions log failures is to use a script that parses JSON log outputs and extracts relevant failure snippets. This approach bypasses manual log reading and surfaces exact changes needed for remediation.