gh-fix-ci

Map failing GitHub PR checks to Actions runs and extract failure log snippets.

Updated Jan 8, 2026
One-click install
npx skills add https://github.com/soham2008xyz/trade-tycoon --skill gh-fix-ci-soham2008xyz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gh-fix-ci
Source: https://github.com/soham2008xyz/trade-tycoon/tree/main/.agents/skills/gh-fix-ci
Command: npx skills add https://github.com/soham2008xyz/trade-tycoon --skill gh-fix-ci-soham2008xyz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps you debug failing GitHub PR checks by locating the specific failing Actions jobs, retrieving the relevant logs, and turning the failure details into a clear, actionable fix plan.

Core Features & Use Cases

  • Diagnose failing checks: Finds failing PR checks from GitHub PR status, then extracts run and job identifiers needed for deeper inspection.
  • Fetch actionable logs: Retrieves the most relevant GitHub Actions log output (with fallbacks when fields change) and captures a concise failure snippet, including “logs pending” handling.
  • Plan with safe change control: Produces a fix plan and explicitly waits for approval before any implementation, while treating non-GitHub providers as out of scope.

Quick Start

Use the gh-fix-ci skill to inspect failing checks for a specific pull request by running the bundled inspector script with your repo path and PR number or URL.

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?

Debugging failing GitHub Actions checks involves mapping the PR check failure to the specific run and job, then extracting the relevant log snippet. This Skill automates resolving the PR number, fetching run metadata via gh, and extracting the failure log.

Can I retrieve GitHub Actions logs when the check status is delayed or pending?

Yes, retrieving GitHub Actions logs includes fallbacks when fields drift or logs are pending. The Skill handles delayed log retrieval by capturing concise failure snippets and gracefully managing pending states during the run inspection.

What is the best way to find the specific GitHub Actions job that caused a PR check to fail?

Finding the failing GitHub Actions job requires fetching the PR status to extract run and job identifiers. This Skill uses the gh CLI to authenticate, fetch check statuses, and isolate the exact job metadata needed for deeper log inspection.

Does this workflow automatically apply fixes to failing GitHub PR checks?

No, this workflow does not automatically apply fixes to failing GitHub PR checks. It produces a summarized failure snippet and an actionable fix plan, then explicitly waits for your approval before any implementation or code changes are made.

Can I use this to debug CI failures from non-GitHub providers like Jenkins or GitLab?

No, you cannot use this to debug CI failures from non-GitHub providers like Jenkins or GitLab. The Skill explicitly treats non-GitHub CI providers as out of scope, focusing solely on GitHub Actions run log analysis and checks.