preflight

Run local linting, testing, and building checks before pushing code.

Updated Jun 6, 2026
One-click install
npx skills add https://github.com/TopengDev/pi-setup --skill preflight-topengdev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: preflight
Source: https://github.com/TopengDev/pi-setup/tree/main/skills/preflight
Command: npx skills add https://github.com/TopengDev/pi-setup --skill preflight-topengdev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps to avoid failed CI/CD workflows by performing local checks before code is pushed, reducing wasted CI/CD runs and ensuring smooth deployments.

Core Features & Use Cases

  • CI/CD Check Automation: Locally execute the same checks that CI would perform, including linting, type checking, testing, and building.
  • Job Step Extraction: Reads and parses CI workflow files to understand the required steps and commands.
  • Quick Results Reporting: Summarizes check results with pass/fail status for linting, types, tests, and building.
  • Auto-Fix Loop: If any checks fail, it guides users through root cause analysis and correction before re-running all checks.

Quick Start

Run the preflight check with the command '/preflight'.

Frequently Asked Questions about preflight

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

FAQPage Schema
How do I run local checks before pushing code to prevent CI/CD failures?

Running local checks before pushing code involves mimicking CI/CD steps locally, including linting, testing, and building. This skill automates that process to catch issues early and ensure build stability.

Can I extract job steps from CI workflow files for local pre-commit execution?

Yes, extracting job steps from CI workflow files is supported. The skill reads and parses your CI configurations to understand required commands, allowing you to run those exact checks locally before committing.

What tools do I need installed to run preflight checks locally?

You need Go, Node.js, and Python tools installed in your environment. These dependencies are required to support the various linting, testing, and building operations executed during the local preflight checks.

How does the auto-fix loop work when local code quality checks fail?

When local code quality checks fail, the auto-fix loop guides you through root cause analysis and correction. After fixing the issues, it automatically re-runs all checks to verify build stability before pushing.

Does preflight work with both pre-commit hooks and manual checks?

Yes, preflight works with both pre-commit hooks and manual checks. You can trigger it using the '/preflight' command to ensure code is ready for CI/CD workflows at any time before pushing.