gh-fix-ci

Diagnose failing GitHub Actions checks and summarize failure logs for pull requests.

2|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/metric-space-ai/ctox --skill gh-fix-ci-metric-space-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gh-fix-ci
Source: https://github.com/metric-space-ai/ctox/tree/main/skills/packs/git/gh-fix-ci
Command: npx skills add https://github.com/metric-space-ai/ctox --skill gh-fix-ci-metric-space-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill helps diagnose failing GitHub Actions checks for pull requests by locating failing checks, fetching logs, summarizing failures, and proposing an approval-based fix plan.

Core Features & Use Cases

  • Inspect PR checks and capture actionable failure details from GitHub Actions.
  • Retrieve and summarize failure logs to provide concise context for triage and planning.
  • Generate an implementation plan after user approval and apply changes in a controlled workflow.

Quick Start

Run the bundled script to inspect PR checks and summarize failures.

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 checks on a pull request?

Debug failing GitHub Actions checks by auditing PR checks via the GitHub API, fetching logs, and extracting failure snippets to summarize root causes. This surfaces actionable failure details and prepares a structured fix plan.

Can I automatically extract error logs from failing GitHub CI workflows?

Yes, you can extract error logs from failing GitHub CI workflows. The skill integrates with the gh CLI and GitHub API to locate failing checks, retrieve raw logs, and isolate relevant failure snippets for triage.

What's the best way to summarize GitHub Actions failures for triage?

Summarize GitHub Actions failures by parsing fetched PR check logs to identify root causes. The skill condenses raw log outputs into concise failure contexts, providing a clear summary for planning and debugging.

Does this skill generate a fix plan after diagnosing PR check failures?

Yes, after diagnosing PR check failures, the skill generates an implementation plan. It proposes an approval-based workflow to apply fixes in a controlled manner, with optional JSON output for automation.

How do I retrieve GitHub Actions logs using the gh CLI for debugging?

Retrieve GitHub Actions logs using the gh CLI by resolving the target pull request and fetching its check runs. The skill automates this process to pull logs directly from GitHub-hosted workflows for analysis.

Why do I need to approve a fix plan before changes are applied to a PR?

You need to approve a fix plan to ensure changes are applied in a controlled workflow. This approval-based mechanism prevents unauthorized automated commits and allows you to review the proposed fix before execution.