MarkdownSchema

Derive and validate markdown schemas for frontmatter fields and heading rules.

5|3|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/N4M3Z/forge-core --skill markdownschema
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: MarkdownSchema
Source: https://github.com/N4M3Z/forge-core/tree/main/skills/MarkdownSchema
Command: npx skills add https://github.com/N4M3Z/forge-core --skill markdownschema

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Infer and enforce consistent markdown schemas to automatically validate every document against forge conventions, eliminating manual schema checks.

Core Features & Use Cases

  • Derives .mdschema definitions from existing markdown documents and aligns them with the forge frontmatter rules.
  • Validates skills, agents, and project docs to ensure required fields and heading structure.
  • Integrates with the mdschema CLI to create, derive, and validate schemas across a repository.

Quick Start

Derive a schema from existing markdown documents and validate it against Forge conventions using the mdschema CLI.

Frequently Asked Questions about MarkdownSchema

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

FAQPage Schema
How do I validate markdown frontmatter fields automatically?

You can validate markdown frontmatter by deriving and enforcing schema definitions that check required fields and heading rules across forge artifacts using the mdschema CLI.

What is the best way to enforce heading structure rules across markdown documents?

Enforcing heading structure rules involves applying markdown schema definitions that specify max_depth and heading constraints, automatically validating all project docs against forge conventions.

How do I derive a markdown schema from existing documents?

Deriving a markdown schema from existing documents uses the mdschema CLI to infer .mdschema definitions from current content and aligns them with forge frontmatter rules.

Do I need the mdschema tool to validate skills and agents?

Yes, validating skills, agents, and docs requires the mdschema CLI to create, derive, and validate schemas across a repository according to forge conventions.

Can I check markdown schema validation for a whole repository at once?

Yes, you can validate markdown schemas across an entire repository by running the mdschema CLI to enforce frontmatter fields and heading rules on all forge artifacts.

Why does markdown schema validation fail on missing frontmatter?

Markdown schema validation fails on missing frontmatter because the derived .mdschema definitions enforce required fields, causing validation to reject documents that do not match forge conventions.