github-ci-fix

Diagnose failing PR checks by pulling GitHub Actions logs with the gh CLI.

3|Updated Jun 15, 2026
One-click install
npx skills add https://github.com/patrickserrano/lacquer --skill github-ci-fix-patrickserrano
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: github-ci-fix
Source: https://github.com/patrickserrano/lacquer/tree/main/core/skills/github-ci-fix
Command: npx skills add https://github.com/patrickserrano/lacquer --skill github-ci-fix-patrickserrano

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? When a pull request fails CI, developers often guess at fixes without reading the actual error logs, waste effort fixing flaky tests, or get stuck trying to access external CI systems. This Skill provides a systematic workflow for identifying, diagnosing, and fixing failing PR checks using the GitHub CLI. ## Core Features & Use Cases - Log-Driven Diagnosis: Pulls failed job logs via gh run view --log-failed and extracts the 20-50 lines around each failure before proposing any fix. - Flaky-vs-Real Triage: Reruns failed jobs on the same commit and inspects run history to distinguish flaky tests from genuine regressions, then scopes the breaking commit with git log or git bisect. - Scope Boundaries: Handles GitHub Actions failures directly while correctly flagging external CI systems (Buildkite, CircleCI) as out of scope, requesting logs from the user instead. - Use Case: A PR shows three failing checks. Use this Skill to identify which are GitHub Actions jobs, pull their logs, confirm one failure is flaky via rerun, scope the real regression to a specific commit, and verify the fix with lacquer wait pr. ## Quick Start Ask the AI to diagnose why the checks on my current pull request are failing and propose a fix based on the actual CI logs.

Frequently Asked Questions about github-ci-fix

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug failing GitHub Actions checks on a pull request?▼

Use `gh pr checks <pr>` to list failing checks, extract the run ID from the details URL, then run `gh run view <run-id> --log-failed` to pull only the failed job logs. Read the 20-50 lines before each failure to diagnose the root cause before making any code changes.

How to tell if a failing CI test is flaky or a real bug?▼

Rerun the failed jobs on the same commit with `gh run rerun <run-id> --failed`. If it passes with no code changes, the test is flaky. You can also check `gh run list --workflow <name>` for a mixed pass/fail pattern across unchanged code.

Can I access Buildkite or CircleCI logs with the gh CLI?▼

No, the gh CLI only accesses GitHub Actions logs. External CI systems like Buildkite and CircleCI are out of scope; report the check URL and ask the user to share the relevant logs instead of attempting workarounds.

Why should I not trust gh pr checks --watch exit code for green CI?▼

The `gh pr checks --watch` command exits 0 even when checks fail, so its exit code cannot prove green CI. Use `lacquer wait pr <N>` instead, which returns distinct exit codes for passed, failed, timed out, and missing checks.

What authentication is required to debug GitHub Actions failures?▼

The gh CLI must be authenticated with repo and workflow scopes. Verify with `gh auth status`; if unauthenticated, run `gh auth login --scopes repo,workflow` before attempting any log access or rerun operations.