gha — Claude Code skill: what it does, how to install
gha — a skill that investigates GitHub Actions failures: finds the breaking commit, checks run history, and searches for open PRs with a fix.
LicenseRef-Proprietary ★ 10,363 updated 2026-09-25
npx skills add ykdojo/claude-code-tips --skill gha -a claude-codeWhat gha 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.
What it helps with
- 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 for the agent
- Investigate this workflow failure by link
- Check which commit broke the CI
- Find if there is an open PR fixing this run
How to install gha
1Skills CLI (Vercel)
npx skills add ykdojo/claude-code-tips --skill gha -a claude-code2Manually: put the files in place
~/.claude/skills/gha/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/gha/
1Skills CLI (Vercel)
npx skills add ykdojo/claude-code-tips --skill gha -a codex2Manually: put the files in place
.agents/skills/gha/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ykdojo/claude-code-tips --skill gha -a cursor2Manually: put the files in place
.cursor/skills/gha/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ykdojo/claude-code-tips skills/gha2Manually: put the files in place
.github/skills/gha/SKILL.md1Skills CLI (Vercel)
npx skills add ykdojo/claude-code-tips --skill gha -a gemini-cli2Platform CLI
gemini skills install https://github.com/ykdojo/claude-code-tips --path skills/ghaManually: put the files in place
.devin/skills/gha/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ykdojo/claude-code-tips --skill gha -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about gha
How to install gha in Claude Code?
Run npx skills add ykdojo/claude-code-tips --skill gha -a claude-code; the skill will appear at ~/.claude/skills/gha/SKILL.md.
What does the gha skill do?
It investigates a failed GitHub Actions workflow: identifies what caused the exit code 1, checks job history, determines the breaking commit, and searches for open PRs with a fix.
What does gha require to work?
The gh CLI installed and authenticated; the skill calls gh run view, gh run list, and gh pr list to gather data.