fix-gh-actions

Diagnose and fix failing GitHub Actions workflows, jobs, and CI checks.

4.4k|154|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/fallow-rs/fallow --skill fix-gh-actions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fix-gh-actions
Source: https://github.com/fallow-rs/fallow/tree/main/.agents/skills/fix-gh-actions
Command: npx skills add https://github.com/fallow-rs/fallow --skill fix-gh-actions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Failing GitHub Actions checks block pull requests and releases, and finding the root cause requires digging through workflow files, job logs, and scripts. This Skill provides a structured workflow to identify the failing workflow, job, and step, reproduce the failure locally, and fix the root cause instead of masking symptoms.

Core Features & Use Cases

  • Failure Triage: Identify the exact failing workflow, job, and step using GitHub metadata and repository inspection.
  • Local Reproduction: Reproduce CI failures locally where feasible to validate hypotheses before committing fixes.
  • Root-Cause Fixes: Inspect workflow files, scripts, jq filters, and code paths to fix the smallest root cause, then re-run targeted validation.
  • Use Case: A release job fails on a pull request. Use this Skill to trace the failing step, reproduce it locally, patch the workflow or script, and confirm the fix with targeted validation.

Quick Start

Investigate why the GitHub Actions checks are failing on my pull request and fix the root cause.

Frequently Asked Questions about fix-gh-actions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug a failing GitHub Actions workflow?

Start by identifying the failing workflow, job, and step from the GitHub check output. Then inspect the relevant workflow files, scripts, and code paths, reproduce the failure locally if possible, and fix the smallest root cause before re-running targeted validation.

How to reproduce a GitHub Actions CI failure locally?

Reproduce the failure locally by running the same commands the failing job executes, using the scripts and code paths referenced in the workflow file. Local reproduction confirms the root cause before you commit a fix.

Can this Skill fix failures in a custom GitHub Action?

Yes. When the failure is in the action/ directory or action.yml file, the workflow directs you to also use the github-action-review Skill for deeper inspection of the custom action definition.

Why does a GitHub Actions job fail only in CI but pass locally?

Environment differences such as runner OS, tool versions, or missing secrets often cause CI-only failures. The Skill's workflow addresses this by inspecting workflow configuration and jq filters alongside local reproduction to isolate the discrepancy.

What are the limitations of automated CI failure fixing?

Some failures cannot be reproduced locally, such as those tied to secrets, runner infrastructure, or external services. In those cases the Skill reports residual risk after targeted validation rather than guaranteeing a verified fix.