preflight

Validate git repository setup, CI health, and AWS session status.

1|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/photon-grove/skills --skill preflight-photon-grove
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: preflight
Source: https://github.com/photon-grove/skills/tree/main/skills/preflight
Command: npx skills add https://github.com/photon-grove/skills --skill preflight-photon-grove

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

It helps developers verify that their repository, branch, and environment settings are correct, preventing common misconfigurations that waste time and cause errors.

Core Features & Use Cases

  • Repository Validation: Checks if the current remote matches the expected owner and repo name.
  • Branch and Upstream Check: Ensures you are on a proper branch tracking the correct upstream.
  • Pre-Work Environment Validation: Validates CI status, open PRs, active sessions, and AWS session validity.
  • Use Case: When starting a new feature branch, run this skill to confirm the repo is correctly set up, CI is passing, and no conflicting sessions are active.
  • Technical Checks: Assesses repo health, active sessions in worktrees, and dependency states, reducing risk of integration issues.

Quick Start

Run /preflight with your repository URL to get a detailed health report before beginning new work.

Frequently Asked Questions about preflight

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

FAQPage Schema
How do I validate my git repository and environment before starting work?

Validate git repository and environment readiness by checking remote configuration, branch upstream tracking, CI status, and active sessions to prevent misconfigurations before starting work.

What does a pre-work environment validation check for in a git repo?

Pre-work environment validation assesses repository health, CI passing status, open PRs, active worktree sessions, and AWS session validity to ensure smooth development workflows and reduce integration errors.

How do I check if my git branch is tracking the correct upstream remote?

Checking git branch upstream tracking verifies the current branch matches the expected remote owner and repo name, ensuring proper sync and preventing misconfigurations during feature development.

Can I verify CI health and active sessions before creating a new feature branch?

Yes, verify CI health and active sessions before creating a feature branch by running a preflight check that validates CI passing status, open PRs, and conflicting worktree sessions.

What is the best way to prevent common git misconfigurations when starting new work?

The best way to prevent git misconfigurations is running a preflight validation that checks remote matching, branch upstream tracking, CI status, and dependency states to ensure correct repository setup.

Why does my AWS session validity affect environment readiness for development?

AWS session validity affects environment readiness because expired sessions block resource access; preflight checks validate session activity to prevent integration issues and ensure smooth development workflows.