gh-fix-ci

Diagnose failing GitHub PR checks and draft remediation plans from Actions logs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Debugging and repairing failing GitHub PR checks by analyzing check runs and logs to deliver actionable remediation.

Core Features & Use Cases

  • Inspect failing checks via gh and fetch Actions logs to identify failure points.
  • Summarize failure context, draft a remediation plan, and implement after explicit approval.
  • Narrow scope to GitHub Actions; report external providers' details URLs only when not a GH Actions run.

Quick Start

Run the bundled script to inspect PR checks and fetch failure logs.

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 PR checks from the command line?

To debug failing GitHub Actions PR checks, this tool authenticates with the gh CLI, retrieves PR checks, and extracts failure snippets from Actions logs to provide actionable remediation steps.

What is the best way to extract failure context from GitHub Actions logs?

Extracting failure context from GitHub Actions logs involves resolving PR details, parsing the detailsUrl for run and job IDs, and fetching log data to render human-readable summaries or JSON outputs for review.

Do I need the gh CLI installed to analyze GitHub Actions failures?

Yes, you need the gh CLI installed and authenticated, as the tool relies on it to resolve PR details, fetch log data, and inspect failing checks during the validation workflow.

Can I use this tool to fix CI failures from external providers like CircleCI?

No, the scope is narrowed to GitHub Actions; for external providers, it only reports the details URLs of check runs rather than fetching and parsing their logs.

How does the remediation plan work after analyzing PR check logs?

After analyzing PR check logs, the tool drafts a remediation plan based on the failure context, which requires explicit approval before any implementation steps are executed.

Why are my GitHub Actions logs not parsing correctly for run IDs?

Parsing issues with GitHub Actions logs for run IDs often occur if the detailsUrl format changes or the check run is from an external provider, which the tool does not parse.