gh-fix-ci

Inspects GitHub Actions check failures and extracts actionable CI log context for fix planning.

Updated Nov 23, 2025
One-click install
npx skills add https://github.com/ak-eyther/model-project --skill gh-fix-ci-ak-eyther
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gh-fix-ci
Source: https://github.com/ak-eyther/model-project/tree/main/codex/skills/gh-fix-ci
Command: npx skills add https://github.com/ak-eyther/model-project --skill gh-fix-ci-ak-eyther

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps you quickly diagnose failing GitHub pull request checks by pulling the right CI logs, summarizing the failure context, and turning the result into a practical fix plan.

Core Features & Use Cases

  • PR Check Inspection: Finds failing GitHub Actions checks for a pull request and identifies the relevant run details.
  • Log Retrieval and Summarization: Pulls workflow or job logs, then extracts the most useful failure snippet for review.
  • Fix Planning Workflow: Organizes the issue into a clear plan before implementation, making it easier to approve and apply changes safely.
  • Use Case: When a PR starts failing in CI, use this Skill to determine whether the breakage is in test setup, build steps, or code changes and then decide the next fix.

Quick Start

Ask this Skill to inspect a GitHub pull request with failing checks, summarize the CI failure, 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 fix failing GitHub Actions checks on a pull request?

To fix failing GitHub Actions checks on a pull request, you inspect failing runs, retrieve workflow or job logs, and extract failure context to determine if the issue is in test setup, build steps, or code changes.

Do I need authenticated gh access to retrieve GitHub Actions logs?

Yes, authenticated gh access is required to retrieve GitHub Actions logs. The process relies on the GitHub CLI to pull workflow or job logs and apply resilient check-field fallbacks when identifying the relevant run details for your pull request.

Can this summarize GitHub Actions logs for both run-level and job-level failures?

Yes, it can summarize GitHub Actions logs for run-level and job-level failures. The process retrieves logs with run or job-level fallback handling to ensure it extracts the most useful failure snippet even if one log level is unavailable.

Does this work with non-GitHub Actions CI checks?

No, this does not work with non-GitHub Actions CI checks. Non-GitHub Actions checks are explicitly treated as out of scope, so the tool focuses entirely on diagnosing and planning fixes for GitHub Actions workflow failures.

What's the best way to triage a pull request failing in CI?

The best way to triage a pull request failing in CI is to inspect failing GitHub Actions checks, pull the relevant workflow logs, summarize the failure context, and organize the issue into a clear fix plan before implementation.