When a GitHub Actions check goes red on your PR, this skill automates the tedious part: it uses the gh CLI to find which checks failed, pulls the actual logs, extracts the relevant error snippet, and then leans on the plan skill to draft a fix for your approval before changing any code. It only handles GitHub Actions, so if you've got Buildkite or other external CI, it just reports the URL and moves on. The bundled Python script is smart enough to handle gh's field drift and falling back to job logs when run logs aren't ready yet. Assumes you've already run gh auth login with workflow scopes. Honest take: this is the kind of automation that saves you from copying log snippets into context yourself, but you still need to understand the failure to approve a sensible fix.

skills.sh installs
178
GitHub stars
12.8K
last updated
Jun 3, 2026

Install

$ npx -y skills add composiohq/awesome-codex-skills --skill gh-fix-ci --agent claude-code

Installs into .claude/skills of the current project.

Files

Gh Pr Checks Plan Fix

Overview

Use gh to locate failing PR checks, fetch GitHub Actions logs for actionable failures, summarize the failure snippet, then propose a fix plan and implement after explicit approval.

  • Depends on the plan skill for drafting and approving the fix plan.

Prereq: ensure gh is authenticated (for example, run gh auth login once), then run gh auth status with escalated permissions (include workflow/repo scopes) so gh commands succeed. If sandboxing blocks gh auth status, rerun it with sandbox_permissions=require_escalated.

Inputs

  • repo: path inside the repo (default .)
  • pr: PR number or URL (optional; defaults to current branch PR)
  • gh authentication for the repo host

Quick start

  • python "<path-to-skill>/scripts/inspect_pr_checks.py" --repo "." --pr "<number-or-url>"
  • Add --json if you want machine-friendly output for summarization.

Workflow

Sponsors

Details

Repository
github.com/composiohq/awesome-codex-skills
Category
Debugging
First seen
Jun 3, 2026

More from composiohq/awesome-codex-skills

All 7

Recommended

More Debugging
1charleswiltgen avataraxiom-auto-layout-debuggingcharleswiltgen/axiomUse when encountering "Unable to simultaneously satisfy constraints" errors, constraint conflicts, ambiguous layout warnings, or views positioned incorrectly - 176skills.sh installs
2charleswiltgen avataraxiom-display-performancecharleswiltgen/axiomUse when app runs at unexpected frame rate, stuck at 60fps on ProMotion, frame pacing issues, or configuring render loops. Covers MTKView, CADisplayLink, CAMeta172skills.sh installs
3charleswiltgen avataraxiom-build-performancecharleswiltgen/axiomUse when build times are slow, investigating build performance, analyzing Build Timeline, identifying type checking bottlenecks, enabling compilation caching, o171skills.sh installs
4akillness avatardebuggingakillness/oh-my-skillsdebugging167skills.sh installs
5absolutelyskilled avatarperformance-managementabsolutelyskilled/absolutelyskilledperformance management140skills.sh installs
6cloudai-x avatarerror-handlingcloudai-x/claude-workflow-v2Implements error handling patterns, structured logging, retry strategies, circuit breakers, and graceful degradation. Use when designing error handling, setting135skills.sh installs