gh-fix-ci

Diagnose failing GitHub Actions checks on pull requests and generate fix plans.

8|1|Updated Oct 30, 2025
One-click install
npx skills add https://github.com/akiojin/llm-router --skill gh-fix-ci
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gh-fix-ci
Source: https://github.com/akiojin/llm-router/tree/main/.codex/skills/gh-fix-ci
Command: npx skills add https://github.com/akiojin/llm-router --skill gh-fix-ci

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Inspect GitHub PR checks with gh, pull failing GitHub Actions logs, summarize failure context, draft a fix plan, and implement after user approval.

Core Features & Use Cases

  • Authenticate and inspect PR checks via gh
  • Fetch and summarize failing logs with actionable snippets
  • Draft a concise fix plan and execute after approval
  • Recheck status after applying changes

Quick Start

Run the bundled script to inspect PR checks: python "<path-to-skill>/scripts/inspect_pr_checks.py" --repo "." --pr "<number-or-url>"

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 and fix failing GitHub Actions checks on a pull request?

Use gh-fix-ci to authenticate via gh, fetch failing GitHub Actions logs, summarize failure context with actionable snippets, draft a fix plan, and implement approved changes. The Skill validates your gh setup, resolves the target PR, extracts failure data, and reports external checks by URL.

Can I automate debugging GitHub PR CI failures with the gh CLI?

Yes. gh-fix-ci automates the workflow: it inspects PR checks via gh, pulls and parses failing logs, generates a concise fix plan, and applies changes after you approve them. It rechecks status after implementation.

What's the best way to fetch and summarize GitHub Actions logs from a failing check?

gh-fix-ci extracts failure snippets directly from GitHub Actions logs, summarizes the failure context, and surfaces actionable information. Run the bundled script with your repo path and PR number or URL to retrieve and analyze logs in one step.

Do I need to manually parse GitHub Actions logs to plan a CI fix?

No. gh-fix-ci fetches logs, summarizes failures automatically, and generates a structured fix plan before you decide whether to implement changes. This reduces manual log inspection and accelerates debugging.

What happens after I approve a fix plan—does gh-fix-ci implement the changes?

Yes. After you approve the fix plan, gh-fix-ci applies the changes and rechecks PR status automatically. External checks are reported by URL for manual verification.

What are the limits of using gh for CI diagnostics without a dedicated tool?

Manual gh workflows require fetching logs separately, parsing failure output manually, and coordinating multiple commands. gh-fix-ci consolidates these steps, validates authentication upfront, and surfaces actionable snippets instead of raw logs.