Gh Pr Checks Plan Fix

Use when a user asks to debug or fix failing GitHub PR checks that run in GitHub Actions; use `gh` to inspect checks and logs, summarize failure context, draft a fix plan, and implement only after explicit approval. Treat external providers (for example Buildkite) as out of scope and report only the details URL.

Overview

The Gh Pr Checks Plan Fix skill, hosted in the mxyhi/ok-skills repository, enables AI agents to diagnose and resolve failing GitHub Pull Request checks. By leveraging the GitHub CLI, the skill inspects check statuses and retrieves execution logs to pinpoint the root cause of CI/CD failures within GitHub Actions. After summarizing the failure context, the agent drafts a remediation plan, though implementation only proceeds following explicit user approval. While the skill is optimized for native GitHub Actions, it identifies external providers like Buildkite by reporting their detail URLs without attempting direct debugging. This tool is compatible with agents such as Codex and Claude, utilizing the popularity of its source repository to streamline automated DevOps troubleshooting workflows.

Use Cases

Identifying specific error logs in failing GitHub Actions workflows to determine the cause of a PR block.
Generating a step-by-step plan to resolve environment-related or code-based CI failures.
Automating the implementation of approved fixes for broken build pipelines directly within the PR branch.

Install Notes

# Review source first
open https://github.com/mxyhi/ok-skills/blob/main/gh-fix-ci/SKILL.md

Copy or clone the skill folder into your agent skills directory after reviewing its instructions and scripts.

Security Notes

This skill requires GitHub CLI access and appropriate repository permissions to read logs and modify code. To maintain repository integrity, it enforces a mandatory manual approval step before any proposed fixes are implemented. Users must ensure that the AI agent environment is securely configured to manage GitHub authentication tokens.

Related Skills

PR Comment Handler

mxyhi/ok-skills

DevOps

Help address review/issue comments on the open GitHub PR for the current branch using gh CLI; verify gh auth first and prompt the user to authenticate if not logged in.

CodexClaude Code
reviewgithub
423 starsApache-2.0

Activepieces

TerminalSkills/skills

DevOps

Activepieces is an opensource workflow automation platform — the newest Zapier/n8n alternative. Visual builder, 200+ integrations, code steps, branching, loops, and webhooks. Selfhosted for free with unlimited flows.

CodexClaude Code
typescriptfrontend
71 starsApache-2.0

3proxy

TerminalSkills/skills

DevOps

Deploy 3proxy — the tiny, fast, universal proxy server supporting HTTP(S), SOCKS4/5, port forwarding, and transparent proxying in a single ~200KB binary. Ideal for lightweight proxy setups, proxy chaining, multiuser access with traffic accounting, and scenarios where a full VPN is overkill. This skill covers installati

CodexClaude Code
securitygithub
71 starsApache-2.0

Act

TerminalSkills/skills

DevOps

Overview Act runs GitHub Actions workflows locally using Docker. Test and debug CI pipelines without pushing to GitHub. Supports most GitHub Actions features.

CodexClaude Code
github
71 starsApache-2.0

AI Eval in CI

TerminalSkills/skills

DevOps

Test AI agents and LLM outputs the same way you test code — automated evaluations that run in CI, compare against baselines, and fail the build when quality drops. No dashboards to check manually. Just npx eval run ci and a red or green build.

CodexClaude Code
typescriptdata
71 starsApache-2.0

AdonisJS

TerminalSkills/skills

DevOps

AdonisJS is a fullstack Node.js framework — the "Laravel of Node.js." Unlike Express/Fastify where you assemble everything from packages, AdonisJS ships with an ORM (Lucid), authentication, validation (VineJS), mailer, queues, and testing out of the box. Opinionated, TypeScriptfirst, and productionready.

CodexClaude Code
typescripttesting
71 starsApache-2.0