# Cmd Fix Github Actions

> Fix GitHub Actions failures by analyzing recent workflow runs and applying fixes in a worktree

- Skill: `gsmlg-dev/cmd-fix-github-actions` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gsmlg-dev/cmd-fix-github-actions`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gsmlg-dev/cmd-fix-github-actions/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: gsmlg-dev (https://skillmd.com/u/gsmlg-dev)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/gsmlg-dev/cmd-fix-github-actions

---


Fix GitHub Actions failures from recent workflow runs. Work in a git worktree under `.trees/`. Repeat up to $1 times (default 5).

## Process

1. **Identify failures**: `gh run list --status=failure --limit=5` then `gh run view <run-id> --log-failed` for details
2. **Create worktree**: Branch from the failing ref into `.trees/fix-ci-<short-description>` — create `.trees/` if missing
3. **Analyze and fix**: Categorize failure (test/build/lint/deps/other), fix root cause in the worktree
4. **Verify locally** when possible (e.g. `mix test`, `mix format --check-formatted`, `mix compile`)
5. **Commit with descriptive message**, push the fix branch
6. **Re-check**: `gh run watch` — if still failing, continue next iteration

## Rules

- Fix root causes, not symptoms
- Do not skip/disable tests or modify CI workflow config without human approval
- Do not make unrelated changes
- Keep each commit focused on the specific failure being fixed

## Stop and ask for human review if

- Same failure recurs 3+ times despite different fix approaches
- Failure is caused by secrets, credentials, or external infrastructure
- Fix requires significant architectural changes
- CI workflow YAML itself needs modification