GitHub Actions CI Fix
Overview
Use this skill when the task is specifically about failing GitHub Actions checks on a pull request. This workflow is hybrid by design:
- Use the GitHub app from this plugin for PR metadata, changed files, and review context.
- Use
gh for GitHub Actions checks and logs because the connector does not expose that workflow end to end.
- Summarize the root cause first, propose a focused fix plan, and implement only after explicit approval.
Prereq: authenticate with GitHub CLI once, then confirm with gh auth status. Repo and workflow scopes are typically required for Actions inspection.
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
npx tsx "<path-to-skill>/scripts/inspect_pr_checks.ts" --repo "." --pr "<number-or-url>"
- Add
--json if you want machine-friendly output for summarization.
Workflow
- Verify gh authentication.
- Run
gh auth status in the repo.
- If unauthenticated, ask the user to run
gh auth login (ensuring repo + workflow scopes) before proceeding.
- Resolve the PR.
- If the user provides a PR number or URL, use that directly.
- Otherwise prefer the current branch PR with
gh pr view --json number,url.
- When repo and PR are known, fetch PR metadata and patch context through the GitHub app from this plugin.
- Inspect failing checks (GitHub Actions only).
- Preferred: run the bundled script (handles gh field drift and job-log fallbacks):
npx tsx "<path-to-skill>/scripts/inspect_pr_checks.ts" --repo "." --pr "<number-or-url>"
- Add
--json for machine-friendly output.
- Manual fallback:
gh pr checks <pr> --json name,state,bucket,link,startedAt,completedAt,workflow
- If a field is rejected, rerun with the available fields reported by
gh.
- For each failing check, extract the run id from
detailsUrl and run:
gh run view <run_id> --json name,workflowName,conclusion,status,url,event,headBranch,headSha
gh run view <run_id> --log
- If the run log says it is still in progress, fetch job logs directly:
gh api "/repos/<owner>/<repo>/actions/jobs/<job_id>/logs" > "<path>"
- Scope non-GitHub Actions checks.
- If
detailsUrl is not a GitHub Actions run, label it as external and only report the URL.
- Do not attempt Buildkite or other providers; keep the workflow lean.
- Summarize failures for the user.
- Provide the failing check name, run URL (if any), and a concise log snippet.
- Call out missing logs explicitly and do not over-claim certainty.
- Propose a focused fix plan and wait for approval.
- Keep the plan tied directly to the failing checks and the observed root cause.
- Implement after approval.
- Apply the approved fix locally.
- Run the most relevant local verification available.
- Recheck status and summarize residual risk.
- Suggest re-running the relevant tests and
gh pr checks.
- Report what is still unverified, what may still be flaky, and whether any failing checks were external and therefore not actionable here.
Bundled Resources
scripts/inspect_pr_checks.ts
Fetch failing PR checks, pull GitHub Actions logs, and extract a failure snippet. Exits non-zero when failures remain so it can be used in automation.
Usage examples:
npx tsx "<path-to-skill>/scripts/inspect_pr_checks.ts" --repo "." --pr "123"
npx tsx "<path-to-skill>/scripts/inspect_pr_checks.ts" --repo "." --pr "https://github.com/org/repo/pull/123" --json
npx tsx "<path-to-skill>/scripts/inspect_pr_checks.ts" --repo "." --max-lines 200 --context 40
Guardrails
- Do not imply that the GitHub app can replace
gh for Actions log retrieval.
- Treat non-GitHub Actions providers as report-only unless the user explicitly wants a separate investigation path.
- If the failure is clearly unrelated to the local diff, say so before proposing code changes.
1---2name: "gh-fix-ci"3description: "Use when a user asks to debug or fix failing GitHub PR checks that run in GitHub Actions. Use the GitHub app from this plugin for PR metadata and patch context, and use `gh` for Actions check and log inspection before implementing any approved fix."4metadata:5 source: https://skillmd.com/skills/rojim666/gh-fix-ci6---789# GitHub Actions CI Fix1011## Overview1213Use this skill when the task is specifically about failing GitHub Actions checks on a pull request. This workflow is hybrid by design:1415- Use the GitHub app from this plugin for PR metadata, changed files, and review context.16- Use `gh` for GitHub Actions checks and logs because the connector does not expose that workflow end to end.17- Summarize the root cause first, propose a focused fix plan, and implement only after explicit approval.1819Prereq: authenticate with GitHub CLI once, then confirm with `gh auth status`. Repo and workflow scopes are typically required for Actions inspection.2021## Inputs2223- `repo`: path inside the repo (default `.`)24- `pr`: PR number or URL (optional; defaults to current branch PR)25- `gh` authentication for the repo host2627## Quick start2829- `npx tsx "<path-to-skill>/scripts/inspect_pr_checks.ts" --repo "." --pr "<number-or-url>"`30- Add `--json` if you want machine-friendly output for summarization.3132## Workflow33341. Verify gh authentication.35 - Run `gh auth status` in the repo.36 - If unauthenticated, ask the user to run `gh auth login` (ensuring repo + workflow scopes) before proceeding.372. Resolve the PR.38 - If the user provides a PR number or URL, use that directly.39 - Otherwise prefer the current branch PR with `gh pr view --json number,url`.40 - When repo and PR are known, fetch PR metadata and patch context through the GitHub app from this plugin.413. Inspect failing checks (GitHub Actions only).42 - Preferred: run the bundled script (handles gh field drift and job-log fallbacks):43 - `npx tsx "<path-to-skill>/scripts/inspect_pr_checks.ts" --repo "." --pr "<number-or-url>"`44 - Add `--json` for machine-friendly output.45 - Manual fallback:46 - `gh pr checks <pr> --json name,state,bucket,link,startedAt,completedAt,workflow`47 - If a field is rejected, rerun with the available fields reported by `gh`.48 - For each failing check, extract the run id from `detailsUrl` and run:49 - `gh run view <run_id> --json name,workflowName,conclusion,status,url,event,headBranch,headSha`50 - `gh run view <run_id> --log`51 - If the run log says it is still in progress, fetch job logs directly:52 - `gh api "/repos/<owner>/<repo>/actions/jobs/<job_id>/logs" > "<path>"`534. Scope non-GitHub Actions checks.54 - If `detailsUrl` is not a GitHub Actions run, label it as external and only report the URL.55 - Do not attempt Buildkite or other providers; keep the workflow lean.565. Summarize failures for the user.57 - Provide the failing check name, run URL (if any), and a concise log snippet.58 - Call out missing logs explicitly and do not over-claim certainty.596. Propose a focused fix plan and wait for approval.60 - Keep the plan tied directly to the failing checks and the observed root cause.617. Implement after approval.62 - Apply the approved fix locally.63 - Run the most relevant local verification available.648. Recheck status and summarize residual risk.65 - Suggest re-running the relevant tests and `gh pr checks`.66 - Report what is still unverified, what may still be flaky, and whether any failing checks were external and therefore not actionable here.6768## Bundled Resources6970### scripts/inspect_pr_checks.ts7172Fetch failing PR checks, pull GitHub Actions logs, and extract a failure snippet. Exits non-zero when failures remain so it can be used in automation.7374Usage examples:75- `npx tsx "<path-to-skill>/scripts/inspect_pr_checks.ts" --repo "." --pr "123"`76- `npx tsx "<path-to-skill>/scripts/inspect_pr_checks.ts" --repo "." --pr "https://github.com/org/repo/pull/123" --json`77- `npx tsx "<path-to-skill>/scripts/inspect_pr_checks.ts" --repo "." --max-lines 200 --context 40`7879## Guardrails8081- Do not imply that the GitHub app can replace `gh` for Actions log retrieval.82- Treat non-GitHub Actions providers as report-only unless the user explicitly wants a separate investigation path.83- If the failure is clearly unrelated to the local diff, say so before proposing code changes.