| name | gh-fix-ci |
| description | Use when a user asks to debug or fix failing GitHub PR checks that run in GitHub Actions. Use the configured GitHub integration for PR metadata and patch context, and use `gh` for Actions check and log inspection before implementing any approved fix. |
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 configured GitHub integration 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
python "<path-to-skill>/scripts/inspect_pr_checks.py" --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.