gh-fix-ci

Diagnose failing GitHub Actions checks and draft a fix plan for approval.

Updated Sep 1, 2025
One-click install
npx skills add https://github.com/mathur-exe/annotation-notes --skill gh-fix-ci-mathur-exe
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gh-fix-ci
Source: https://github.com/mathur-exe/annotation-notes/tree/main/PaperNotes/dotfiles/codex/skills/gh-fix-ci
Command: npx skills add https://github.com/mathur-exe/annotation-notes --skill gh-fix-ci-mathur-exe

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill automates the diagnosis and remediation workflow for failing GitHub Actions checks on PRs by inspecting checks, pulling logs, summarizing failures, and drafting a fix plan for user approval.

Core Features & Use Cases

  • Inspect PR checks for a repository using gh to identify failing checks.
  • Retrieve GitHub Actions logs for actionable failure details, extract concise failure snippets, and report external checks with their URLs.
  • Create a plan with the plan skill and apply approved changes to fix CI failures, followed by a recheck of status.

Quick Start

Run the gh-fix-ci skill to analyze PR checks by providing the repo and PR details, which will fetch failing checks, summarize failures, and propose a fix plan for 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 diagnose failing GitHub Actions checks on a pull request?

You can diagnose failing GitHub Actions checks by fetching logs, extracting failure snippets, and summarizing the root cause. This skill automates inspecting PR checks and pulling logs to identify why your CI pipeline is failing.

Can I automatically fix failing CI checks after a pull request fails?

Yes, you can automatically fix failing CI checks by generating a remediation plan from the summarized log failures. After you approve the drafted plan, the skill applies the changes and rechecks the GitHub Actions status.

Do I need gh authentication to debug GitHub Actions logs?

Yes, you need gh authentication to debug GitHub Actions logs. The skill requires gh access to PR checks to fetch logs, extract failure details, and coordinate the remediation plan for the repository.

What is the best way to summarize GitHub Actions log failures for a fix plan?

The best way to summarize GitHub Actions log failures is to extract concise failure snippets from the logs and use a plan skill to draft a targeted fix. This ensures accurate remediation before applying code changes.

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

Your CI fix workflow requires plan approval to ensure the drafted changes accurately address the summarized GitHub Actions failures. This prevents incorrect modifications by validating the remediation strategy before rechecking the PR status.