gh-fix-ci

Diagnose failing GitHub Actions checks and generate a fix plan.

1|Updated Dec 21, 2025
One-click install
npx skills add https://github.com/cdrguru/portable-agent-kit --skill gh-fix-ci-cdrguru
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gh-fix-ci
Source: https://github.com/cdrguru/portable-agent-kit/tree/main/.codex/skills/gh-fix-ci
Command: npx skills add https://github.com/cdrguru/portable-agent-kit --skill gh-fix-ci-cdrguru

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

gh-fix-ci offers a guided workflow to diagnose failing GitHub CI checks by fetching and analyzing Actions logs and presenting a concrete fix plan for user approval.

Core Features & Use Cases

  • Retrieve PR check results and GitHub Actions logs to identify failure points.
  • Summarize failure context into a concise snippet and propose a corrective plan for reproducible fixes.
  • Scope non-GitHub-Action checks by providing the details URL and clear boundaries for remediation.

Quick Start

Run the gh-fix-ci skill to inspect a PR's failing checks and produce a fix plan.

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 on a pull request, this skill retrieves and analyzes logs to surface failure snippets and generate a concise fix plan for user approval.

What is the best way to generate a fix plan for failing CI checks?

The best way to generate a fix plan for failing CI checks is summarizing GitHub Actions failure context into a concise snippet, then proposing reproducible corrective actions based on retrieved PR log data.

Do I need gh authentication to analyze GitHub Actions logs?

Yes, you need gh authentication to analyze GitHub Actions logs. This skill requires gh authentication to securely retrieve PR check results and fetch the necessary log data for diagnosing failures.

Can I use Python standard library to fetch GitHub PR check results?

Yes, you can use Python standard library to fetch GitHub PR check results. This skill uses only the Python standard library to coordinate optional script execution and analyze Actions logs without external dependencies.

How to handle non-GitHub-Action checks when diagnosing CI failures?

To handle non-GitHub-Action checks when diagnosing CI failures, provide the details URL and clear boundaries for remediation. This scopes the analysis appropriately and prevents overstepping into unsupported check types.

Why does my CI fix plan require approval before applying changes?

Your CI fix plan requires approval to ensure reproducible fixes are reviewed before implementation. The skill generates a concise corrective plan from failure snippets and waits for user approval before proceeding with optional script execution.