gh-fix-ci

Diagnose failing GitHub Actions checks and summarize actionable failure context.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps developers quickly locate, summarize, and resolve failing GitHub Actions checks on pull requests so they can reduce CI turnaround time and unblock merges. It automates the discovery of failing checks, pulls actionable log snippets, and guides a concise remediation workflow that requires explicit human approval before code changes are applied.

Core Features & Use Cases

  • Inspect PR Checks: Uses the GitHub CLI to find the relevant PR and list checks with their metadata.
  • Fetch and Parse Logs: Retrieves run and job logs, detects pending or zipped logs, and extracts a focused failure snippet for diagnosis.
  • Plan-and-Approve Workflow: Drafts a concise fix plan (integrates with a create-plan skill if available), requests approval, implements approved fixes, and rechecks status.
  • Use Case: Diagnose a failing test or build on a pull request, summarize the root cause with a log snippet, propose a minimal fix, and re-run checks after applying changes.

Quick Start

Run the gh-fix-ci skill to inspect the current pull request, summarize failing GitHub Actions logs, and draft a concise fix plan for 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 diagnose failing GitHub Actions checks on a pull request?

To diagnose failing GitHub Actions checks, the skill uses the gh CLI to fetch PR checks, run metadata, and logs, extracting concise failure snippets for diagnosis. It automates discovery of failing checks and summarizes the root cause.

How do I extract failure snippets from GitHub Actions logs?

You extract failure snippets from GitHub Actions logs by retrieving run and job logs via the gh CLI. The skill detects pending or zipped logs and parses them to isolate focused failure context for review.

Can I automatically fix CI failures on GitHub pull requests?

You can fix CI failures by drafting a concise remediation plan from the extracted logs and requesting explicit human approval. The skill implements approved fixes and rechecks the GitHub Actions status.

Do I need authenticated gh CLI access to inspect GitHub Actions logs?

Yes, you need authenticated gh CLI access with repository and workflow scopes to inspect GitHub Actions logs. The skill requires this access to fetch PR checks and execute the included script for deeper log extraction.

What is the best way to resolve a failing build on a GitHub pull request?

The best way to resolve a failing build is to automate the discovery of failing GitHub Actions checks, pull actionable log snippets, and follow a concise remediation workflow that requires explicit human approval before applying code changes.

Are there limitations when parsing zipped GitHub Actions logs?

Parsing zipped GitHub Actions logs requires detecting and processing pending or zipped log files. The skill handles this by extracting a focused failure snippet, but it requires explicit human approval before applying any fixes.