Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ykdojo/claude-code-tips --skill gha -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/gha/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/gha/

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.

Similar skills

All skills for DevOps and infrastructure →

From the same set9

version-check version-check helps decide whether to update Claude Code or hold back on the current build. Evaluates release risks using changelogs and issue trackers. CX Codex +1 ★ 10,363repo stars review-claudemd The review-claudemd skill examines recent chats and suggests changes to global and project-level CLAUDE.md files. Use it to spot repeated instruction failures and stale rules. CX Codex +1 ★ 10,363repo stars reddit-fetch The reddit-fetch skill pulls posts and comments off Reddit through its JSON API when automated access gets blocked. Handy for research threads your agent can't reach. CX Codex +1 ★ 10,363repo stars quarter-clone The quarter-clone skill trims an active conversation down to its final quarter. It cuts token consumption while preserving the latest instructions and files. CX Codex +1 ★ 10,363repo stars private-github-search The private-github-search skill searches public and private GitHub repositories through a local mirror. Use it when you need to locate code or files across several repositories. CX Codex +1 ★ 10,363repo stars hn-summarize hn-summarize — a skill that pulls top Hacker News and hckrnews.com stories, fetches the linked articles, and groups the comment threads by theme. CX Codex +1 ★ 10,363repo stars handoff Creates or updates a HANDOFF.md file so an agent in a fresh session can pick up the task with full context. CX Codex +1 ★ 10,363repo stars half-clone The half-clone skill creates a new session from the later part of the current conversation. Use it when the early history is no longer needed but recent work should remain. CX Codex +1 ★ 10,363repo stars

Project sponsors

Companies that keep this analytics open