gh-fix-ci

The gh-fix-ci skill helps diagnose and resolve failing pull request checks that run in GitHub Actions. It is designed for situations where a user needs to understand why a GitHub PR check failed and determine the appropriate remediation steps. The skill uses the GitHub CLI (`gh`) to inspect pull request checks, retrieve workflow and job logs, extract actionable failure information, and present a concise summary of the underlying issue. Rather than making immediate changes, it follows a structured workflow that emphasizes review and approval before implementation.

Key capabilities include verifying GitHub CLI authentication, resolving pull requests from either the current branch or a provided PR reference, inspecting failing GitHub Actions checks, collecting workflow logs, and extracting relevant failure snippets. The skill supports a bundled inspection script that simplifies log retrieval and failure analysis, with an optional JSON output mode for machine-friendly processing. It also includes fallback procedures using native GitHub CLI commands when needed. External CI providers are intentionally excluded from detailed analysis; for those checks, the skill reports only the available details URL. After analyzing failures, it generates a concise fix plan and waits for explicit user approval before implementing changes.

This skill is intended for developers, maintainers, and engineering teams who manage repositories that use GitHub Actions for continuous integration. Common use cases include investigating failed PR validations, identifying test or workflow errors, reviewing CI logs before making code changes, and creating an approval-based remediation process. It is particularly useful for repositories that rely on GitHub CLI access and GitHub-hosted workflow execution.