gh-fix-ci

Diagnose failing GitHub PR checks and draft a fix plan using gh CLI.

1|1|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/RamonsDka/the-architect-overlay --skill gh-fix-ci-ramonsdka
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gh-fix-ci
Source: https://github.com/RamonsDka/the-architect-overlay/tree/main/skills/gh-fix-ci
Command: npx skills add https://github.com/RamonsDka/the-architect-overlay --skill gh-fix-ci-ramonsdka

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

GitHub PR checks can fail in opaque ways, causing delays in code review. This skill helps you diagnose failing PR checks by using gh to inspect checks and logs, summarize failure context, and draft a fix plan for approval.

Core Features & Use Cases

  • Log retrieval and failure localization: fetches detailsUrl Run logs and summarizes the failure context for quick triage.
  • Plan-driven remediation: creates a concise fix plan and prompts for approval before applying changes.
  • Scope-aware execution: limits actions to GitHub Actions-based checks and excludes external providers, ensuring a lean workflow.

Quick Start

Tell the AI to run the gh-fix-ci skill on the current repository to identify and plan fixes for failing PR 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 PR checks using logs?

To diagnose failing GitHub PR checks, this skill uses the gh CLI to fetch GitHub Actions run logs and summarize the failure context for quick triage. It inspects checks and localizes the exact issue.

Can I automatically fix GitHub Actions workflow failures?

You can automatically fix GitHub Actions workflow failures through a plan-driven remediation process. This skill drafts a concise fix plan and requires explicit user approval before applying changes and rechecking the PR status.

Does this tool work with external CI providers or only GitHub Actions?

This tool works only with GitHub Actions-based checks and explicitly excludes external CI providers. Scope-aware execution limits diagnostic and remediation actions to GitHub Actions, ensuring a lean workflow.

What is the best way to triage opaque GitHub PR check failures?

The best way to triage opaque GitHub PR check failures is using gh to inspect checks and fetch logs. This skill summarizes the failure context and drafts a targeted fix strategy for your approval.

Do I need to approve the fix plan before changes are applied to my PR?

Yes, you need to approve the fix plan before changes are applied to your PR. The skill drafts a remediation plan and executes the approved changes only after explicit user confirmation, then rechecks the status.