plan-validate-structure

Validate plan directory structure and file format compliance against a 9-section template.

1|Updated Nov 17, 2025
One-click install
npx skills add https://github.com/HomericIntelligence/ProjectKeystone --skill plan-validate-structure-homericintelligence
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-validate-structure
Source: https://github.com/HomericIntelligence/ProjectKeystone/tree/main/.claude/skills/plan-validate-structure
Command: npx skills add https://github.com/HomericIntelligence/ProjectKeystone --skill plan-validate-structure-homericintelligence

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the validation of plan directory structures and file format compliance, preventing errors and ensuring consistency before changes are committed or issues are created.

Core Features & Use Cases

  • Structure Validation: Checks for the presence, order, and formatting of all required sections in plan files.
  • Hierarchy Validation: Verifies parent/child links, nesting, and the existence of all references within the plan structure.
  • Content Validation: Ensures essential elements like titles, overviews, numbered steps, and success criteria checkboxes are correctly implemented.
  • Use Case: Before submitting a new project plan, run this skill to catch any structural or formatting errors, saving review time and ensuring adherence to established templates.

Quick Start

Use the plan-validate-structure skill to validate all plans in the notes/plan directory.

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 markdown formatting and section ordering in project plan directories?

This Skill checks plan directories against a defined 9-section template, verifying section presence, ordering, and markdown formatting compliance. It ensures all plan files adhere to established structural requirements before submission.

What is the best way to check parent/child links and nesting in plan documentation?

Plan structure validation verifies parent/child links, nesting, and the existence of all references within the plan structure. It ensures all relative links in your documentation are valid and correctly implemented.

Can I use this to ensure success criteria checkboxes and numbered steps are correctly implemented?

Yes, content validation checks that essential elements like titles, overviews, numbered steps, and success criteria checkboxes are correctly implemented. It confirms these structural components are present and properly formatted in plan files.

When do I need to run a plan structure compliance check before committing changes?

Run plan structure compliance checks before submitting a new project plan or committing changes. Running validation at this stage catches structural or formatting errors early, saving review time and ensuring template adherence.

Does this validation require specific directory setups or plan file formats to work?

This validation requires plan files in the notes/plan directory formatted using valid markdown. It applies to project planning and documentation management workflows, requiring specific markdown formatting and valid relative linking for all files.