ci-failure-triage
Use when GitHub Actions or local quality gates fail and the root cause is not already isolated.
SKILL.md.claude/skills/ci-failure-triage/SKILL.md
GitHubCI Failure Triage
Follow AGENTS.md first.
Workflow
- Identify the failing job, command, and first meaningful error; avoid chasing downstream failures first.
- Reproduce locally with the closest Makefile target, usually
make ci-localor the focused target named in the job. - Classify the failure as formatting, lint, typecheck, test, Docker, dependency, or infrastructure.
- Fix the root cause in the narrowest file set and avoid weakening checks unless the check itself is demonstrably wrong.
- Re-run the focused failing command, then the broader gate that failed.
- Before handoff, report the exact command results and whether
make ci-localpasses.