local-ci-mirror-preflight

What problem does it solve?

This Skill prevents avoidable CI surprises by mirroring pull-request checks locally first, then comparing the same checks against a clean mainline baseline so failures can be attributed correctly instead of guessed at.

Core Features & Use Cases

• Workflow-derived validation: Reads the repository's CI workflow definitions and derives the closest local equivalent of every PR-triggered check.
• Baseline-first failure classification: Runs checks in a separate git worktree on origin/main before judging the current change, then classifies failures as PR-caused, pre-existing-on-main, CI-infrastructure, or cannot-determine-locally.
• Docs-only lightweight path: Supports an explicit docs-only route with reduced validation when the diff matches the repo's docs-only definition.
• Closeout-ready reporting: Produces a structured preflight record with commands run, durations, classifications, and residual risk notes.
• Use case: Before committing a feature branch, use this Skill to confirm the same checks CI will run, prove whether a failure belongs to your change or main, and decide whether it is safe to commit.

Quick Start

Ask for a local CI mirror preflight for your branch, including a clean-main baseline comparison and a failure classification report.