preflight-check

Validates git working state before commits, branches, or pull requests.

5|3|Updated May 19, 2026
One-click install
npx skills add https://github.com/awinogradov/code-assistants --skill preflight-check-awinogradov
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: preflight-check
Source: https://github.com/awinogradov/code-assistants/tree/main/claude-plugins/autopilot/skills/preflight-check
Command: npx skills add https://github.com/awinogradov/code-assistants --skill preflight-check-awinogradov

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill validates the git working state to prevent issues before committing, branching, or opening pull requests, such as detecting uncommitted changes, incorrect branch states, and out-of-date 'main'.

Core Features & Use Cases

  • Branch Validation: Checks if the current branch is merged and up-to-date.
  • Change Detection: Identifies uncommitted changes to prevent unintended commits.
  • Environment Health: Ensures that the git environment is in a clean state before proceeding with code changes.
  • Use Case: Before opening a pull request, run 'preflight-check' to ensure that the branch is correct and that there are no uncommitted changes that could cause problems.

Quick Start

Execute the preflight-check skill with the command: Skill(preflight-check)

Frequently Asked Questions about preflight-check

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

FAQPage Schema
How do I check for uncommitted changes before opening a pull request?

To check for uncommitted changes before opening a pull request, you need a preflight git validation process that detects dirty working states and incorrect branch configurations. This skill performs that environment validation to ensure your repository is clean before proceeding.

What is a pre-commit check for branch validation?

A pre-commit check for branch validation is a process that verifies your current branch is merged and up-to-date with the main branch. It prevents unintended commits by ensuring your git environment health before you start making code changes.

How do I ensure my main branch is up to date before branching?

To ensure your main branch is up to date before branching, run a preflight check that validates your git working state against the remote repository. This detects out-of-date main branches and prompts you to pull the latest changes before creating a new branch.

Does this git preflight check require bash to run?

Yes, this git preflight check requires bash to execute git operations and handle user interaction for confirmation or correction. You need a bash-compatible environment to validate uncommitted changes and branch states effectively.

What is the best way to prevent committing to an incorrect git branch?

The best way to prevent committing to an incorrect git branch is to use an automated preflight check that validates branch states before you proceed. This ensures your git environment is in a clean, correct state and prevents unintended commits from being pushed.

Why does my pull request fail due to a dirty git environment?

Your pull request may fail due to a dirty git environment if uncommitted changes or an out-of-date main branch cause conflicts. Running a preflight check detects these issues beforehand, ensuring code quality and a clean working state before opening the PR.