Skip to content
/gh-fix-ciOfficial

Debug and fix failing GitHub Actions CI by inspecting checks, fetching logs, and proposing targeted fixes.

GitHubCI/CDDevOps· 2 min read

Quick import: Download the .md file and save it to .claude/commands/ (Claude Code), .cursorrules (Cursor), or paste as a system prompt in ChatGPT, Gemini, or any LLM API.

#What it does

The gh-fix-ci skill debugs failing GitHub Actions CI pipelines. It uses the GitHub CLI to inspect PR checks, fetch action logs, extract failure snippets, summarize root causes, and propose a fix plan. It only implements changes after explicit approval.

#How to use

bash
$gh-fix-ci
Inspect failing GitHub Actions checks in this repo, summarize root cause, and propose a focused fix plan.

#Workflow

  1. Verify gh authentication -- Run gh auth status and ensure repo + workflow scopes
  2. Resolve the PR -- Find the current branch PR or use a provided PR number/URL
  3. Inspect failing checks -- Fetch GitHub Actions logs with the bundled script or manual fallback
  4. Scope external checks -- Label non-GitHub Actions checks as external, report only the URL
  5. Summarize failures -- Provide failing check name, run URL, and concise log snippet
  6. Create a fix plan -- Draft a concise plan and request approval before implementing
  7. Implement after approval -- Apply fixes, summarize diffs/tests, offer to open a PR
  8. Recheck status -- Suggest re-running tests and gh pr checks to confirm

#Bundled script

bash
python "<path-to-skill>/scripts/inspect_pr_checks.py" --repo "." --pr "<number-or-url>"

Add --json for machine-friendly output. The script handles gh field drift and job-log fallbacks.

#Prerequisites

  • GitHub CLI (gh) authenticated with repo + workflow scopes
  • Python 3 for the bundled inspection script

This skill is from the OpenAI Skills Catalog.

OpenAI·
View all skills