GitHub PR Check Fixer
Diagnoses failed GitHub Actions checks and prepares an approval-gated fix plan.
The skill is evidenced as primarily performing read-only gh queries and log retrieval, asks the user to authenticate when needed, and requires explicit approval before implementing changes. However, it requests repo and workflow scopes without documenting sensitive data in logs, data flows, least-privilege boundaries, or rollback, so points are deducted.
The script includes authentication checks, PR resolution, field-compatibility fallback, run-log/job-log fallback, and explicit error states. It has no committed tests, marks ZIP-formatted API logs as unparseable, and uses coarse failure-marker extraction. Static review cannot exceed 10 points, so points are deducted.
The audience, inputs, GitHub Actions scope, and non-GitHub- Actions boundary are reasonably clear. Applicability is limited by assumptions about the current branch PR, dependence on GitHub CLI and GitHub network access, and no stated Chinese-language or mainland-China reachability support.
The skill provides overview, prerequisites, inputs, quick start, workflow, and bundled-resource documentation, with mostly stable naming and entry points. It lacks a skill version, changelog, named maintenance responsibility, and update path; license status is not confirmed in the supplied material, and the repository README marks the repository deprecated, so points are deducted.
The script can identify failing checks, retrieve run metadata and logs, extract snippets, and emit text or JSON, covering the core diagnostic task. Fix implementation still depends on a subsequent agent workflow, log parsing may be incomplete, and no statically verifiable representative outputs or comparative benefit evidence are supplied, so points are deducted.
The source code, parameters, and failure branches are auditable, but there is no committed test suite, CI coverage, or third-party execution evidence. The conclusion therefore rests on limited static evidence and receives only a low score.
- Confirm the GitHub CLI authentication scopes before execution, and avoid writing or displaying logs containing tokens, secrets, or personal data.
- GitHub API job logs may be returned as ZIP archives, which this script treats as unparseable; manually verify that logs are genuinely unavailable.
- The repository is marked deprecated; confirm an active maintenance source and compatibility before adoption.
- GitHub service and CLI reachability may be limited from mainland-China networks.
What it does & when to use it
This skill is designed to debug or fix failed GitHub Actions checks on GitHub pull requests. It uses the GitHub CLI to inspect check status, run details, and logs, then extracts an actionable failure snippet and summarizes the context. It proposes a fix plan before making changes and implements only after explicit approval. External providers such as Buildkite are out of scope.
Verifies gh authentication; resolves the current branch PR or a supplied PR number or URL; reads GitHub Actions checks, run metadata, and logs; fetches job logs through the GitHub API when a run is still in progress; extracts and summarizes failure snippets; labels non-GitHub Actions checks as external and reports only their details URL; after approval, applies the fix and suggests rerunning tests and gh pr checks.
- A developer needs to investigate failed GitHub Actions checks on the PR for the current branch.
- A maintainer provides a PR number or URL and wants its failing checks inspected.
- A team needs concise, machine-friendly failure context extracted from lengthy CI logs.
- A check is still running and job-level logs must be fetched directly for actionable details.
Pros & cons
- Covers PR resolution, check inspection, log retrieval, failure summarization, and approval-gated implementation.
- Includes inspect_pr_checks.py with optional JSON output.
- Keeps scope focused on GitHub Actions and avoids attempting work with external CI providers.
- Requires an authenticated GitHub CLI and typically repo and workflow scopes.
- Handles GitHub Actions only; external checks such as Buildkite are limited to reporting their details URL.
- The source provides no test suite, cross-platform validation, or concrete repair strategy.
- The repository is deprecated; its README recommends the OpenAI Plugins repository for current Codex skill and plugin examples.
How to install
Install the curated skill in Codex with: $skill-installer gh-fix-ci. Restart Codex after installation so it can load the skill. The README does not state an independent license for this skill; check LICENSE.txt in the skill directory.
How to use
First run gh auth login and ensure the usual repo and workflow scopes are available. Example: python "<path-to-skill>/scripts/inspect_pr_checks.py" --repo "." --pr "123". Add --json for machine-friendly output. A suitable trigger is: “Inspect this PR’s GitHub Actions failures, summarize the logs, and propose a fix plan; do not modify anything without my approval.”
Compared to similar skills
The repository is deprecated; its README recommends the OpenAI Plugins repository for current Codex skill and plugin examples.