commit-preflight

Inspect GitHub Actions workflow gates and run local preflight checks.

7|2|Updated Dec 14, 2025
One-click install
npx skills add https://github.com/asafelobotomy/iCloud-Drive-Downloader --skill commit-preflight
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: commit-preflight
Source: https://github.com/asafelobotomy/iCloud-Drive-Downloader/tree/main/.github/skills/commit-preflight
Command: npx skills add https://github.com/asafelobotomy/iCloud-Drive-Downloader --skill commit-preflight

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about commit-preflight

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run GitHub Actions workflow checks locally before pushing a commit?

To run GitHub Actions workflow checks locally before pushing, the Skill reads your `.github/workflows/*.yml` files, matches branch and path filters against your staged files, and executes local equivalents of the workflow steps to block avoidable CI failures.

Can I automatically fix CI linting errors on staged files before a git push?

Yes, you can automatically fix CI linting errors on staged files before a push. The Skill performs scope-safe repairs, auto-fixing only failures that can be resolved within your candidate file set while reporting exact blockers for out-of-scope issues.

How does local CI preflight handle missing workflow dependencies and tool probing?

Local CI preflight handles missing dependencies by probing your environment for required tools and prompting you for approval before installing only the specific dependencies needed to execute the matching workflow steps deterministically.

What is the difference between running a preflight check and just executing a workflow linting script?

Running a preflight check differs from simple workflow linting because it builds an ordered execution plan from matching `run` and `uses` steps, probes dependencies, captures exit statuses, and returns an allow, block, or residual-risk decision with a concise audit summary.

Does commit preflight work with path filters and branch triggers in GitHub Actions YAML?

Yes, commit preflight works directly with path filters and branch triggers. It inspects active GitHub Actions workflow gates by reading the YAML files and selecting only workflows whose `branches`, `paths`, and other filters match the candidate commit or unpushed branch.