About preflight
preflight is a skill that builds a production readiness checklist from the current branch's diff. It is for developers preparing a merge, grouping actionable findings by type and confidence and citing the files that support each item.
Key features
- 01Inspect the current branch diff against main
- 02Identify production follow-up actions
- 03Group items by type and confidence
- 04Cite the relevant file for each item
- 05Include only diff-supported findings
Use cases
- 01Review database migrations and configuration before a merge
- 02Check production readiness for workers or external services
- 03Organize production verification and monitoring tasks
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ unlearndev/ skills --skill preflightAfter installing, type/preflightin Claude Code to confirm it loaded.
Details
From the project READMEPreflight
Produce a production pre-flight checklist for the current branch.
Steps
- Get the diff against the base branch:
git diff main...HEAD. - Read every changed hunk. Look for things that need action in production once
this merges — for example:
- new environment variables / config keys
- new or changed database migrations
- work pushed onto a queue (needs a worker running)
- new external services, mail, storage, or credentials
- Build a checklist of those items. Group them primarily by type — a
freeform category that fits the work, choosing whatever labels suit the diff.
Common ones (not a fixed list):
- Database — migrations, schema, seed data.
- Infrastructure — queue workers, schedulers, services that must run.
- Configuration — env vars, config keys, credentials.
- Operational — things to confirm or watch in production.
- Within each type, sub-group the items by confidence. Use whatever confidence label fits — for example Required (broken without it), Verify / Likely (almost certainly needed, depends on setup), Recommended / Nice to confirm (worth a glance, may already be handled).
- For every item, cite the file in the diff that implies it (no line numbers).
Rules
- Only include items the diff actually supports. Do not guess or pad the list.
- If a type or confidence group has no items, omit it.
- Order types so the most action-required ones come first.
- Render each type as a real heading: the name on its own line with an
underline rule of box-drawing dashes (
────) directly beneath it, matching the width of the name. Confidence labels stay as plain sub-headings. - Keep the output short: type heading, confidence sub-heading, one line per item. No preamble, no summary.
Comments
Markdown supported