github-actions-failure-triage

Installation
SKILL.md

GitHub Actions failure triage

Use this skill when a repository already uses GitHub Actions and the task is to diagnose or minimally fix a failing workflow run, job, or check.

Use this skill when

  • The user asks why a GitHub Actions run, job, or check is failing.
  • A workflow started failing after a workflow edit, action version bump, runner change, cache change, matrix change, or reusable workflow change.
  • A post-migration GitHub Actions regression needs diagnosis, but the repository is already on GitHub Actions.
  • The likely best outcome is a targeted fix, a precise explanation, or a clean escalation path rather than a broad CI redesign.

Do not use this skill when

  • The main task is CI-platform migration planning, parity mapping, or retirement of another CI system.
  • The main task is handling PR review comments, pushing a fix batch, or waiting for post-push checks.
  • The main task is worktree or branch isolation for parallel work.
  • The user is asking for greenfield CI design or a broad GitHub Actions redesign with no concrete failing run to anchor on.
  • The primary action required is changing org-admin settings, runner fleet configuration, branch protection, or environment policy rather than diagnosing a repository-owned failure.
Installs
13
GitHub Stars
4
First Seen
Jul 16, 2026