plan-validate-structure

Validate plan documents against Template 1 structure and hierarchy.

18|5|Updated Nov 3, 2025
One-click install
npx skills add https://github.com/mvillmow/ml-odyssey --skill plan-validate-structure
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-validate-structure
Source: https://github.com/mvillmow/ml-odyssey/tree/main/.claude/skills/plan-validate-structure
Command: npx skills add https://github.com/mvillmow/ml-odyssey --skill plan-validate-structure

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? This Skill ensures all planning documents adhere to a strict 9-section format (Template 1), preventing inconsistencies and making plans easier to understand, track, and convert into GitHub issues. It automates structural validation, reducing manual checks.

Core Features & Use Cases:

  • Structure Validation: Checks for the presence and order of all required sections in plan.md files.
  • Hierarchy & Content Checks: Validates parent/child links, numbered steps, and checkbox criteria for completeness.
  • Use Case: Before committing a new project plan, use this skill to automatically validate its structure. This ensures it meets project standards and can be seamlessly integrated into the issue generation workflow, saving time and ensuring quality.

Quick Start: Use the plan-validate-structure skill to validate the plan file 'notes/plan/01-foundation/plan.md'.

Frequently Asked Questions about plan-validate-structure

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

FAQPage Schema
How do I validate a project plan document against a standard structure?

Plan validation checks your markdown files against a 9-section Template 1 format, verifying section presence, order, hierarchy, links, and required fields. Run the validation script on your plan.md to detect formatting and content inconsistencies before committing.

What does Template 1 structure mean for planning documents?

Template 1 is a strict 9-section format that standardizes project plans. It enforces section order, parent-child link integrity, numbered step compliance, and checkbox criteria completeness, ensuring all plans follow the same documented structure.

Can I automate checks for plan formatting consistency?

Yes. The validation scripts automatically check for section presence, order, hierarchy integrity, relative link validity, and required field completion. This reduces manual review and catches structural issues before plans are converted to GitHub issues.

When should I validate a plan document structure?

Validate your plan before committing to version control or converting it into GitHub issues. Early validation prevents inconsistencies, ensures quality, and integrates seamlessly into your issue generation workflow.

What happens if my plan doesn't meet Template 1 compliance?

The validator reports which sections are missing, out of order, have hierarchy issues, broken links, or incomplete content. You can then fix these specific problems to achieve full compliance with the 9-section standard.

Does plan validation work with notes in the CLAUDE project?

Yes. The validation applies to notes and plan content in the CLAUDE project and related planning workflows, supporting your existing project structure and documentation practices.