About w-gha
w-gha is a repository skill for diagnosing and fixing failing GitHub Actions on the current branch. It uses gh to inspect checks, runs, logs, and artifacts, then directs developers to reproduce workflow commands locally; it avoids commits or pushes unless requested.
Key features
- 01Inspect branch and upstream state
- 02Review GitHub Actions checks and runs
- 03Read failed logs and download artifacts
- 04Analyze distinct failed jobs in parallel
- 05Re-run workflow commands locally
- 06Avoid unrequested commits and pushes
Use cases
- 01Investigating failed GitHub Actions runs
- 02Tracing test, lint, build, or environment failures
- 03Reproducing workflow steps on a local machine
- 04Diagnosing multiple failed jobs
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ blockmatic/ basilic-skills --skill w-ghaAfter installing, type/w-ghain Claude Code to confirm it loaded.
Bundled filesreferences/git-publish.md
Details
From the project READMEFix failing GitHub Actions for the current branch. Use gh, never GitHub MCP for Actions logs. Follow git publish.
git branch --show-current. Resolve the upstream tracking branch and confirm it exists.git status -sbis 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.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>.- 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.
- Re-run the same local commands the workflow uses. Do not add
gh run watchto every push. No commit or push unless the user requested that action. - Docs:
/w-docsif behavior or commands changed.
Comments
Markdown supported