gh-fix-ci

Identify failing GitHub Actions checks on a PR and assemble a remediation plan.

Updated Dec 17, 2024
One-click install
npx skills add https://github.com/LAF-US/IDAHO-VAULT --skill gh-fix-ci-laf-us
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gh-fix-ci
Source: https://github.com/LAF-US/IDAHO-VAULT/tree/main/.codex/plugins/cache/openai-curated/github/314574a046f21938025ae443f9c6dbbd0c2c9b7a/skills/gh-fix-ci
Command: npx skills add https://github.com/LAF-US/IDAHO-VAULT --skill gh-fix-ci-laf-us

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill helps engineers quickly diagnose and fix failing GitHub Actions checks on pull requests by aggregating failing checks, fetching logs, and proposing a focused remediation plan.

Core Features & Use Cases

  • Inspect failing PR checks across GitHub Actions runs and surface root causes.
  • Retrieve run and job metadata (workflow name, status, headBranch, headSha, url) to contextualize failures.
  • Generate a focused fix plan and apply changes after explicit approval to minimize blast radius.

Quick Start

Analyze a PR with failing CI checks and generate a prioritized remediation plan for fast restoration of green 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 diagnose failing GitHub Actions checks on a pull request?

To diagnose failing GitHub Actions checks, you can retrieve run and job metadata alongside relevant logs to identify root causes. This process aggregates workflow status, headBranch, and headSha data to assemble a structured remediation plan for fast restoration of green checks.

What is the best way to fix failing CI checks on a GitHub PR?

Fixing failing CI checks involves inspecting failing PR checks across GitHub Actions runs and surfacing root causes from the logs. You can then generate a focused fix plan and apply changes after explicit approval to minimize blast radius.

Do I need GitHub CLI authentication to analyze failing PR checks?

Yes, GitHub CLI (gh) authentication is required to analyze failing PR checks. This allows the process to securely retrieve workflow run metadata, fetch relevant job logs, and surface root causes for your pull request failures.

Can I automate the remediation plan for failing GitHub Actions?

You can automate the remediation plan by using the structured summary generated from the fetched GitHub Actions logs and run metadata. This summary is suitable for automation, proposing a focused fix plan that is applied only after explicit approval.

Why does my GitHub Actions job fail and how do I find the root cause?

GitHub Actions jobs fail due to various build or test errors found in the workflow logs. By retrieving run and job metadata along with relevant logs, you can surface the exact root cause and generate a prioritized remediation plan.

What context does a GitHub Actions diagnostic summary include for failing checks?

The diagnostic summary for failing checks includes workflow name, status, headBranch, headSha, and url. This job metadata contextualizes the GitHub Actions failures and helps assemble a targeted remediation plan.