# gha

gha — a skill that investigates GitHub Actions failures: finds the breaking commit, checks run history, and searches for open PRs with a fix.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · ★ 10363 repo stars
- Author: ykdojo
- License: LicenseRef-Proprietary · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ykdojo/claude-code-tips/tree/HEAD/skills/gha/SKILL.md
- Updated: 2026-09-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/gha

## What it does

The agent takes a failed run link and uses `gh` CLI to fetch logs, pinpoint what caused the exit code 1, and review the last 10–20 runs of the same job — distinguishing a one-off flake from a stable breakage. If the job fails consistently, the skill identifies the first failing commit and the last passing one, validates the hypothesis across the full history, and reports the breaking commit with high confidence.

The output is a report with flakiness rating, success rate, root cause, and a recommendation for fixing it. Before that, the skill searches open PRs that already address the same issue; if found, the agent will provide the PR number and link instead of its own advice. Without `gh` CLI in `PATH`, the skill will not run.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add ykdojo/claude-code-tips --skill gha -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/gha/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/gha/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add ykdojo/claude-code-tips --skill gha -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/gha/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add ykdojo/claude-code-tips --skill gha -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/gha/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ykdojo/claude-code-tips skills/gha
```

2. **Manually: put the files in place**
- File: `.github/skills/gha/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add ykdojo/claude-code-tips --skill gha -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/ykdojo/claude-code-tips --path skills/gha
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/gha/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add ykdojo/claude-code-tips --skill gha -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/ykdojo/claude-code-tips/tree/HEAD/skills/gha/SKILL.md

## When to use it
- figure out why a GitHub Actions workflow failed
- locate the commit that broke a job
- check whether a test is flaky or consistently broken
- separate warnings from actual errors in logs
- find an open PR that already fixes the issue

## Example prompts
- Investigate this workflow failure by link
- Check which commit broke the CI
- Find if there is an open PR fixing this run

## Similar
- [gha-security-review](https://affpapa.org/en/nevibecode/skills/gha-security-review.md) — skill · 5100 installs
- [openai-gh-fix-ci](https://affpapa.org/en/nevibecode/skills/openai-openai-gh-fix-ci.md) — skill · ★ 540 repo stars
- [w-gha](https://affpapa.org/en/nevibecode/skills/w-gha.md) — skill · 647 installs
- [fix-ci](https://affpapa.org/en/nevibecode/skills/fix-ci.md) — skill · 2600 installs
- [mcore-create-issue](https://affpapa.org/en/nevibecode/skills/mcore-create-issue.md) — skill · 1800 installs
- [ci-pipeline](https://affpapa.org/en/nevibecode/commands/ci-pipeline.md) — command · 470 installs

From the same set: [ykdojo/claude-code-tips](https://affpapa.org/en/nevibecode/by/ykdojo/claude-code-tips.md) — 9 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
