gh-fix-ci

Diagnose failing GitHub Actions PR checks and propose targeted fixes.

1|Updated Dec 1, 2025
One-click install
npx skills add https://github.com/SatoryKono/BioactivityDataAcquisition --skill gh-fix-ci-satorykono
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gh-fix-ci
Source: https://github.com/SatoryKono/BioactivityDataAcquisition/tree/main/docs/skills/global/gh-fix-ci
Command: npx skills add https://github.com/SatoryKono/BioactivityDataAcquisition --skill gh-fix-ci-satorykono

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Quickly diagnose and repair failing GitHub Actions PR checks by collecting logs, extracting actionable failures, and guiding through a safe fix plan that is executed only after explicit approval.

Core Features & Use Cases

  • Inspect PR checks with gh to locate failing runs and fetch summary data.
  • Retrieve actionable failure snippets from CI logs and correlate them with the relevant PR.
  • Propose a concise, approval-based fix plan using an integrated planning workflow, then apply changes after user confirmation.

Quick Start

Run the bundled script to inspect PR checks for a repository and PR number, review the generated failure summary, and follow the proposed plan after approval.

Frequently Asked Questions about gh-fix-ci

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix failing GitHub Actions PR checks?

You fix failing GitHub Actions PR checks by using gh authentication to fetch checks, retrieve run metadata and logs, and extract actionable failure snippets. The tool then proposes a concise fix plan that is implemented only after explicit approval.

How do I extract failure snippets from GitHub Actions CI logs?

You extract failure snippets from GitHub Actions CI logs by fetching run results and metadata through gh authentication. The process correlates the extracted log failures directly with the relevant PR to isolate the root cause.

Can I automatically apply fixes to failing GitHub Actions PR checks?

You cannot automatically apply fixes without confirmation. The workflow generates a concise repair plan using an integrated planning workflow, but it implements changes to your repository only after receiving explicit user approval.

Do I need gh authentication to debug GitHub Actions CI failures?

Yes, you need gh authentication to debug GitHub Actions CI failures. The diagnostic process relies on gh commands to fetch PR checks, retrieve run metadata, and download the logs required to propose a targeted fix.

What is the best way to diagnose GitHub Actions PR check failures?

The best way to diagnose GitHub Actions PR check failures is to fetch run metadata and logs via gh, extract actionable failure snippets from the output, and correlate them with the PR to generate a targeted, approval-based fix plan.

Does this workflow support proposing a plan before modifying repository files?

Yes, the workflow supports proposing a plan before modifying repository files. It generates a concise fix plan using an integrated planning workflow and waits for explicit approval before implementing any changes to resolve the CI failure.