gh-fix-ci

Diagnoses GitHub PR check failures and drafts a remediation plan.

5.0k|454|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/tech-leads-club/agent-skills --skill gh-fix-ci-tech-leads-club
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gh-fix-ci
Source: https://github.com/tech-leads-club/agent-skills/tree/main/packages/skills-catalog/skills/%28tooling%29/gh-fix-ci
Command: npx skills add https://github.com/tech-leads-club/agent-skills --skill gh-fix-ci-tech-leads-club

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps software teams quickly identify and fix failing GitHub PR checks by using the GitHub CLI (gh) to locate failing checks, fetch logs, summarize failure context, and draft a remediation plan. It keeps scope focused on GitHub Actions and treats external providers (for example Buildkite) as out of scope.

Core Features & Use Cases

  • Locate failing checks with gh pr checks and extract run metadata and details URLs.
  • Fetch GitHub Actions logs and produce a concise failure snippet for faster triage.
  • Draft a remediation plan and require explicit approval before applying any changes.
  • Apply fixes and recheck status, facilitating a smooth CI repair workflow in code reviews.

Quick Start

Use the gh-fix-ci skill to inspect PR checks and generate a plan:

  • python "<path-to-skill>/scripts/inspect_pr_checks.py" --repo "." --pr "<number-or-url>"
  • Add --json for machine-friendly output to feed into reviews or automation. After reviewing the plan, provide explicit approval to apply changes and re-run checks.

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 PR checks using gh CLI?

Debug failing GitHub Actions PR checks by fetching run details and logs with gh CLI, summarizing failure context, and generating a concrete remediation plan for review. The Skill confines operations strictly to GitHub Actions while ignoring external CI providers.

Can I automate CI debugging for GitHub Actions pull requests?

Automate CI debugging by running a Python script that extracts failing check metadata and URLs via gh pr checks, producing concise failure snippets. You can add --json for machine-friendly output to feed into automated reviews or downstream pipelines.

Does this CI debugging tool work with external providers like Buildkite?

No, this CI debugging tool does not work with external providers like Buildkite. It strictly confines operations to GitHub Actions checks, treating all external CI providers as out of scope to maintain focused log analysis and remediation.

What is the best way to analyze GitHub Actions logs for PR failures?

Analyze GitHub Actions logs for PR failures by fetching run logs and extracting a concise failure snippet to accelerate triage. The tool drafts a remediation plan and requires explicit user approval before applying any fixes or rechecking status.

Why does the GitHub Actions fix require explicit approval?

Explicit approval is required to ensure user control over repository changes during GitHub Actions debugging. The tool drafts a remediation plan from log analysis but waits for explicit consent before applying fixes and re-running checks to facilitate safe CI repair.