md-validator

Validate Markdown files against centralized workspace conventions with optional fixes.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/fabioabr/ia-ws --skill md-validator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: md-validator
Source: https://github.com/fabioabr/ia-ws/tree/main/projects/discovery-to-go/base/behavior/skills/md-validator
Command: npx skills add https://github.com/fabioabr/ia-ws --skill md-validator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The validator checks Markdown files against centralized workspace conventions to ensure consistency, quality, and maintainability of all documentation and skills.

Core Features & Use Cases

  • Validates frontmatter completeness and structure
  • Enforces heading hierarchy, emoji usage, acronym treatment, wikilinks, callouts, diagrams, and naming conventions
  • Supports recursive folder validation and optional auto-fix

Quick Start

Run the validator on a target path to check Markdown conformance and optionally fix issues.

Frequently Asked Questions about md-validator

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

FAQPage Schema
How do I validate markdown files against workspace conventions?

To validate markdown files against workspace conventions, run the validator on a target file or directory to identify compliance issues across frontmatter, headings, wikilinks, and naming structures using a centralized rule set.

Can I automatically fix markdown linting issues across a directory?

Yes, you can automatically fix markdown linting issues across a directory by applying the validator recursively with the --fix option to enforce frontmatter completeness, heading hierarchy, and acronym treatment.

What markdown quality rules does a workspace convention validator enforce?

A markdown quality validator enforces workspace conventions by checking frontmatter completeness, heading structure, emoji usage, acronym treatment, wikilinks, callouts, diagrams, naming, and skill-fields.

Does markdown validation work recursively on entire documentation folders?

Yes, markdown validation works recursively on entire documentation folders, allowing you to scan directory trees to ensure documentation consistency, quality, and maintainability across all files.

What is the best way to enforce frontmatter completeness in markdown documentation?

The best way to enforce frontmatter completeness in markdown documentation is using a centralized validation tool that checks file structure against workspace conventions and optionally applies automatic fixes.

Why does my markdown heading hierarchy fail workspace convention checks?

Your markdown heading hierarchy fails workspace convention checks because the validator enforces specific structural rules, identifying and reporting non-compliant heading structures across your files.