preflight

Lint branch-changed files with ESLint, markdownlint, and actionlint.

Updated Jul 10, 2026
One-click install
npx skills add https://github.com/acme-skunkworks/changelog-core --skill preflight-acme-skunkworks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: preflight
Source: https://github.com/acme-skunkworks/changelog-core/tree/main/.agents/skills/preflight
Command: npx skills add https://github.com/acme-skunkworks/changelog-core --skill preflight-acme-skunkworks

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires eslint, markdownlint-cli2, actionlint, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps automate the preflight process of linting only the files a branch has changed, reducing manual work and improving code quality.

Core Features & Use Cases

  • Change-Gated Linting: Lints only the files changed in a branch compared to its base, reducing unnecessary linters execution.
  • Branch-Scope: Automatically detects and lints only the relevant files based on the branch changes.
  • Error Classification: Classifies violations as introduced or pre-existing, and handles them accordingly.
  • Integration with CI/CD: Can be used as a lint gate in a CI/CD workflow to ensure code quality before merging.

Quick Start

Run the preflight script from the repository root to check for linting issues in the branch changes.

Frequently Asked Questions about preflight

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

FAQPage Schema
How do I lint only changed files in a Git branch before merging?

Branch-scoped linting targets only modified files by comparing your branch against its base. This change-gated preflight identifies relevant updates and runs ESLint, markdownlint, and actionlint exclusively on them to ensure code quality before merging.

How does this preflight process classify linting violations?

The preflight process classifies linting violations as either introduced or pre-existing. By evaluating branch changes against the base, it separates new errors from legacy issues and handles them accordingly to keep your CI/CD pipeline focused on current changes.

Can I use this linting preflight as a CI/CD pipeline gate?

Yes, you can integrate this linting preflight directly into a CI/CD workflow as a quality gate. It automates the linting process for code changes in a branch, ensuring that introduced violations are caught and resolved before merging.

Do I need ESLint and markdownlint installed to run branch-scoped linting?

Yes, branch-scoped linting requires ESLint, markdownlint-cli2, and actionlint installed in your environment. These dependencies execute the actual code, markdown, and GitHub Actions validation checks against the files changed in your branch.

What is the best way to automate pre-commit linting for GitHub Actions and Markdown?

Automating pre-commit linting for GitHub Actions and Markdown is best handled by a change-gated preflight script. It automatically detects branch changes and runs actionlint and markdownlint only on modified files to reduce manual work and improve CI/CD efficiency.

Why should I use change-gated linting instead of linting the entire repository?

Change-gated linting reduces unnecessary linter execution by only checking files a branch has changed compared to its base. This reduces manual work, speeds up CI/CD pipelines, and isolates introduced violations from pre-existing errors in the codebase.