pre-commit-formatting

Lint Markdown files and normalize whitespace during GitHub PR creation.

3|Updated Dec 7, 2025
One-click install
npx skills add https://github.com/Grimblaz/agent-orchestra --skill pre-commit-formatting
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pre-commit-formatting
Source: https://github.com/Grimblaz/agent-orchestra/tree/main/skills/pre-commit-formatting
Command: npx skills add https://github.com/Grimblaz/agent-orchestra --skill pre-commit-formatting

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This backstop formatting gate ensures final markdown and whitespace alignment during PR creation, catching drift before validation evidence capture.

Core Features & Use Cases

  • Automated formatting gate: runs a markdown lint pass on edited Markdown files.
  • Whitespace normalization: standardizes whitespace to prevent noise in diffs.
  • PR hygiene workflow: prevents formatting regressions by auto-detecting and guiding fixes during PR creation.

Quick Start

Trigger the gate on a PR to ensure consistent formatting across changed files before merge.

Frequently Asked Questions about pre-commit-formatting

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

FAQPage Schema
How do I fix markdown formatting drift before creating a pull request?

To fix markdown formatting drift before creating a pull request, trigger an automated formatting gate to run a markdownlint pass on edited files, standardizing whitespace and preventing validation errors.

What is whitespace normalization in a git pre-commit workflow?

Whitespace normalization in a git pre-commit workflow is standardizing whitespace characters to prevent unnecessary noise in file diffs, ensuring consistent presentation across changed non-Markdown files before merge.

Does this markdownlint gate work with GitHub repositories using Code-Conductor?

Yes, this markdownlint gate works with GitHub repositories using Code-Conductor, applying a final markdown lint pass and whitespace normalization during PR creation to capture clean validation evidence.

What is the best way to automate markdown lint checks during PR creation?

The best way to automate markdown lint checks during PR creation is using a formatting gate that leverages markdownlint-cli2 for Markdown linting and a PowerShell whitespace normalizer to guide fixes before validation.

Why does my pull request fail validation due to formatting errors?

Your pull request fails validation due to formatting errors because final markdown and whitespace alignment drifted during editing, requiring a backstop formatting gate to catch and guide fixes before evidence capture.