w-gha — Claude Code skill: what it does, how to install
w-gha — a Claude Code skill that retrieves GitHub Actions logs with gh, analyzes failures, and helps fix CI errors locally. Invoke it to investigate a failed workflow on the current branch.
MIT 647 installs ★ 1 updated 2026-10-02
npx skills add blockmatic-icebox/basilic-skills --skill w-gha -a claude-codeWhat w-gha does
w-gha investigates failed GitHub Actions runs for the current branch. It uses gh to find runs, read failed-job logs, and download artifacts; GitHub MCP is not used for Actions logs. The skill checks the upstream branch before choosing runs. If the local HEAD is ahead, it can identify the PR head SHA and use that to select the relevant runs.
It examines failures in tests, linting, builds, dependencies, environment settings, and timeouts, then reruns the workflow’s local commands. When two or more jobs fail, it starts a separate read-only parser for each distinct job and handles the underlying fix itself. It does not commit or push unless the user asks.
What it helps with
- locate logs for a failed GitHub Actions run
- trace a test or build failure to its cause
- download artifacts from a failed run
- select CI runs using the PR head SHA
Example prompts for the agent
- Investigate the failed GitHub Actions run for the current branch and suggest a local fix.
- Find the logs for the failed PR check and identify which workflow command caused the failure.
How to install w-gha
1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-gha -a claude-code2Manually: put the files in place
~/.claude/skills/w-gha/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/w-gha/
1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-gha -a codex2Manually: put the files in place
.agents/skills/w-gha/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-gha -a cursor2Manually: put the files in place
.cursor/skills/w-gha/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install blockmatic-icebox/basilic-skills skills/workflow/w-gha2Manually: put the files in place
.github/skills/w-gha/SKILL.md1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-gha -a gemini-cli2Platform CLI
gemini skills install https://github.com/blockmatic-icebox/basilic-skills --path skills/workflow/w-ghaManually: put the files in place
.devin/skills/w-gha/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-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 w-gha
How do I install w-gha in Claude Code?
Run npx skills add blockmatic-icebox/basilic-skills --skill w-gha -a claude-code. The skill file is at ~/.claude/skills/w-gha/SKILL.md.
What does w-gha do?
It retrieves GitHub Actions logs with gh, analyzes job failures, and reruns workflow commands locally. It does not commit or push unless asked.
What does w-gha need to work?
It uses the gh command to retrieve Actions logs and run details.
Source text
SKILL.md · MIT
--- name: w-gha description: Retrieve GitHub Actions logs with gh, analyze failures, and fix CI errors locally. disable-model-invocation: true --- Fix failing GitHub Actions for the current branch. Use **`gh`**, never GitHub MCP for Actions logs. Follow [git publish](references/git-publish.md). 1. `git branch --show-current`. Resolve the upstream tracking branch and confirm it exists. `git status -sb` is not proof the branch is pushed. Confirm HEAD is not ahead of upstream, or identify the PR head SHA (`gh pr view --json headRefOid`) and use that SHA when selecting runs. 2. `gh pr checks`; `gh run list --branch "$(git branch --show-current)" --limit 10` (or `--commit <headSha>`); failed run → `gh run view <id> --log-failed`; artifacts → `gh run download <id>`. 3. Parse logs for tests, lint, build, missing deps, env, timeouts. When 2+ jobs failed, spawn one read-only parser per distinct job. Change the owning cause yourself. 4. Re-run the same local commands the workflow uses. Do not add `gh run watch` to every push. No commit or push unless the user requested that action. 5. Docs: `/w-docs` if behavior or commands changed.
© blockmatic-icebox · MIT · blockmatic-icebox/basilic-skills