version: "1.0.0" name: gh-fix-ci description: Inspect GitHub PR checks with gh, pull failing GitHub Actions logs, summarize failure context, then create a fix plan and implement after user approval. Use when a user asks to debug or fix failing PR CI/CD checks on GitHub Actions and wants a plan plus code changes; for external checks (e.g., Buildkite), only report the details URL and mark them out of scope.

GH Fix CI

Use this skill to diagnose failing GitHub Actions checks on a PR and propose a fix plan.

Workflow

1) Verify auth:

• gh auth status -h github.com

2) Identify the PR:

• gh pr view --json number,title,url
• If no PR is found, ask for the PR URL.

3) List checks:

• gh pr checks

4) For GitHub Actions failures, fetch logs:

• gh run view <run-id> --log
• If you only have a job id: gh run view --job <job-id> --log

5) Summarize the root cause and impacted files. 6) Propose a fix plan and get user approval before changing code. 7) For external checks (non-GitHub Actions), report the details URL and mark as out of scope.

Notes

• Do not rerun CI unless the user asks.
• Keep the failure summary concise and actionable.