spec-preflight

Verify a Linear issue's spec against actual project state.

6|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/withpiper/pipekit --skill spec-preflight
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-preflight
Source: https://github.com/withpiper/pipekit/tree/main/skills/spec-preflight
Command: npx skills add https://github.com/withpiper/pipekit --skill spec-preflight

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Empirical pre-flight checks on a Linear issue's spec. Verifies file paths, line refs, phase-detect baseline, Linear status, and dependencies against reality. Read-only.

Core Features & Use Cases

  • Verify file paths cited in the spec exist in the repository.
  • Validate line citations and phase-detect baselines against actual files and tool outputs.
  • Compare reported Linear status and dependencies to the real state to surface drift before /launch.
  • Read-only, safe to run as a gating check before progressing.

Quick Start

Run preflight on a Linear issue to verify file paths, line refs, and dependencies before launching.

Frequently Asked Questions about spec-preflight

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

FAQPage Schema
How do I verify a Linear issue spec against the actual project state before launch?

To verify a Linear issue spec before launch, run a preflight check that compares cited file paths, line references, and phase-detect baselines against the repository. It surfaces divergences between the spec and reality without modifying any files.

Can I check Linear dependencies and file paths without modifying my project files?

Yes, you can check Linear dependencies and file paths without modifying project files by running a read-only preflight verification. This safely validates spec citations and surfaces status drift before progressing to launch.

What is a preflight spec verification for Linear issues?

A preflight spec verification for Linear issues is an empirical check that identifies divergences between a ticket's spec and the actual project state. It validates file paths, line references, phase-detect baselines, and dependencies to produce a verbose verdict.

How do I validate line citations and phase-detect baselines from a Linear ticket?

You validate line citations and phase-detect baselines by running a preflight check on the specific Linear issue. The process compares the ticket's cited references against actual files and tool outputs to ensure the spec remains accurate.

When should I run a spec verification check on a Linear issue?

You should run a spec verification check on a Linear issue right before launch. It operates as a gating check to compare the reported Linear status and dependencies to the real state, surfacing any drift before you progress.

Does preflight spec verification work on a specific Linear issue or a whole project?

Preflight spec verification operates on a specific Linear issue rather than a whole project. It checks the cited file paths, line references, and dependencies for that individual ticket to ensure its spec is still accurate.