gh-fix-ci

Use when a user asks to debug or fix failing GitHub PR checks that run in GitHub Actions. Uses `gh` to inspect checks and logs, summarize failure context, draft a fix plan, and implement only after explicit approval. Treats external providers (for example Buildkite) as out of scope and reports only the details URL. Do NOT use for addressing PR review comments (use gh-address-comments) or general CI outside GitHub Actions.

tech-leads-club/agent-skills|Updated May 23, 2026

Works with

Claude CodeCursorClineWindsurf

Installation Guide

Select your AI agent

How to use gh-fix-ci on Cursor

AI-first code editor with Composer

Prerequisites

Before installing skills in Cursor, ensure your development environment meets these requirements:

›Cursor installed and configured on your machine
›Node.js 16+ with npm — verify with node --version
›Active project directory where you want to add gh-fix-ci

Run the install command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/tech-leads-club/agent-skills --skill gh-fix-ci

Fetches gh-fix-ci from tech-leads-club/agent-skills and configures it for Cursor.

Select Cursor when prompted

The CLI shows a list of agents. Use arrow keys and space to select Cursor:

◆ Which agents do you want to install to?

│

│ ── Universal (.agents/skills) ────────────────

│ · Cline · Codex · Goose · Windsurf

│ ●Cursor(selected)

│ · Cursor · Aider · Continue

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/gh-fix-ci

Restart Cursor to activate gh-fix-ci. Access via /gh-fix-ci in your agent's command palette.

⚠

Security Notice

We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.

Skills execute code in your environment. Always review source, verify the publisher, and test in isolation before production.

›View source on GitHub ›Skills CLI docs ›About Cursor ›What are agent skills?

Documentation

List & Monetize Your Skill

Submit your Claude Code skill and start earning

Get started →

Use Cases

Task Automation & Efficiency

Automate repetitive workflows and reduce manual effort

Example

Generate reports, summarize documents, draft communications

✓

Save 3-5 hours per week on routine tasks

Knowledge Enhancement

Learn new skills, understand complex topics, get expert guidance

Example

Explain concepts, provide examples, suggest learning resources

✓

Accelerate learning and skill development by 2x

Quality Improvement

Enhance output quality through reviews, suggestions, and refinements

Example

Review drafts, suggest improvements, catch errors

✓

Improve work quality by 30-40% with less effort

Overview

Use gh to locate failing PR checks, fetch GitHub Actions logs for actionable failures, summarize the failure snippet, then propose a fix plan and implement after explicit approval.

If a plan-oriented skill (for example create-plan) is available, use it; otherwise draft a concise plan inline and request approval before implementing.

Prereq: authenticate with the standard GitHub CLI once (for example, run gh auth login), then confirm with gh auth status (repo + workflow scopes are typically required).

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.

Prefer the current branch PR: gh pr view --json number,url.
If the user provides a PR number or URL, use that directly.

Inspect failing checks (GitHub Actions only).

Preferred: run the bundled script (handles gh field drift and job-log fallbacks):
- python "<path-to-skill>/scripts/inspect_pr_checks.py" --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.

Create a plan.

Use the create-plan skill to draft a concise plan and request approval.

Implement after approval.

Apply the approved plan, summarize diffs/tests, and ask about opening a PR.

Recheck status.

After changes, suggest re-running the relevant tests and gh pr checks to confirm.

Bundled Resources

scripts/inspect_pr_checks.py

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:

python "<path-to-skill>/scripts/inspect_pr_checks.py" --repo "." --pr "123"

python "<path-to-skill>/scripts/inspect_pr_checks.py" --repo "." --pr "https://github.com/org/repo/pull/123" --json

python "<path-to-skill>/scripts/inspect_pr_checks.py" --repo "." --max-lines 200 --context 40

gh-fix-ci

Installation Guide

How to use gh-fix-ci on Cursor

Prerequisites

Run the install command

Select Cursor when prompted

Verify installation

Security Notice

Documentation

List & Monetize Your Skill

Use Cases

Task Automation & Efficiency

Knowledge Enhancement

Quality Improvement

Install Skill

Gh Pr Checks Plan Fix

Overview

Inputs

Quick start

Workflow

Bundled Resources

scripts/inspect_pr_checks.py

Implementation Guide

Best Practices

When to Use This

Learning Path

Related Skills

mermaid-studio

chrome-devtools

excalidraw-studio

create-rfc

codenavi

react-composition-patterns

Reviews

Discussion

name	gh-fix-ci
description	Use when a user asks to debug or fix failing GitHub PR checks that run in GitHub Actions. Uses `gh` to inspect checks and logs, summarize failure context, draft a fix plan, and implement only after explicit approval. Treats external providers (for example Buildkite) as out of scope and reports only the details URL. Do NOT use for addressing PR review comments (use gh-address-comments) or general CI outside GitHub Actions.
metadata	author: github.com/openai/skills version: '1.0.0'