commit-preflight

What problem does it solve?

This Skill prevents wasted time from GitHub Actions failures by inspecting the repo’s active workflows before you commit or push, then running the closest matching local checks to catch issues early.

Core Features & Use Cases

• Workflow discovery & gating: Reads .github/workflows/*.yml and selects only workflows whose branches, paths, and other filters match the candidate commit/push.
• Local preflight planning: Converts workflow run: steps and common uses: actions into deterministic local commands, ordered from cheapest to most expensive.
• Dependency probing and optional installs: Detects missing tools via command probing and asks you whether to install only the required ones.
• Scope-safe repairs: Auto-fixes only failures that can be repaired within the candidate file set; otherwise reports exact blockers and commands.
• Pass/block/residual-risk decision: Produces a clear summary of executed checks, skipped checks (and why), any auto-fixes, and whether the commit/push may proceed.

Quick Start

Ask the assistant to run commit preflight checks for your staged changes, and respond to any missing-tool prompts so it can verify the matching GitHub Actions gates locally.