plan-validator

Validate plan markdown files against repository rules from CLAUDE.md and plans/README.md.

Updated Feb 24, 2026
One-click install
npx skills add https://github.com/CeJIDb/sab-win-26-parking --skill plan-validator-cejidb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-validator
Source: https://github.com/CeJIDb/sab-win-26-parking/tree/main/.claude/skills/plan-validator
Command: npx skills add https://github.com/CeJIDb/sab-win-26-parking --skill plan-validator-cejidb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams ensure every plan file in plans/ adheres to the repository's planning standards, preventing invalid or inconsistent plans from entering the workflow.

Core Features & Use Cases

  • Checks that plan filenames follow YYYY-MM-DD-slug.md format with a valid date and kebab-case slug.
  • Enforces an H1 heading as the first non-empty line of content.
  • Validates presence and formatting of phases marked with [ ] or [x].
  • Ensures a non-empty final "## Итог" section at the end of the document.
  • Applies rules from CLAUDE.md and plans/README.md to drive automated plan reviews.

Quick Start

Run the validator before committing or updating plans to automatically verify format compliance.

Frequently Asked Questions about plan-validator

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

FAQPage Schema
How do I validate markdown plan files against repository rules?

Markdown plan validation checks filenames for YYYY-MM-DD-slug.md format, enforces H1 headings as the first non-empty line, verifies phase markers like [ ] or [x], and ensures a non-empty final Итог block to maintain document consistency.

How do I enforce date-formatted filenames and headers in markdown plans?

To enforce date-formatted filenames and headers in markdown plans, use a validation tool that checks for YYYY-MM-DD-slug.md kebab-case format and requires an H1 heading as the first non-empty line of the document content.

Can I integrate markdown plan validation into pre-commit hooks?

Yes, you can integrate markdown plan validation into pre-commit hooks. Running the validator before committing automatically verifies format compliance, preventing invalid or inconsistent plans from entering the workflow.

What format do plan filenames need to follow for markdown validation?

Plan filenames need to follow the YYYY-MM-DD-slug.md format for markdown validation. This requires a valid date prefix and a kebab-case slug to pass the repository's planning standards checks.

Does the validator check phase markers and final content structure in markdown?

Yes, the validator checks phase markers and final content structure in markdown. It validates the presence and formatting of phases marked with [ ] or [x] and ensures a non-empty final Итог section at the end of the document.

Why does my markdown plan fail validation before a commit?

Your markdown plan fails validation before a commit if it violates repository rules from CLAUDE.md and plans/README.md, such as incorrect filename format, missing H1 header, invalid phase markers, or an empty final Итог block.