MD Design System

A Markdown formatting and sanitization skill that cleans and standardizes Markdown files while preserving their original meaning, requirements, decisions, and intent. It helps keep documentation, Agent Skills, architecture files, READMEs, and other Markdown content consistent, readable, and predictable.

What It Does

• Normalizes headings, lists, code blocks, links, spacing, and document structure.
• Preserves the original meaning and avoids unnecessary rewriting.
• Applies consistent formatting rules across different Markdown document types.
• Helps reduce messy, duplicated, or inconsistent formatting.
• Provides a repeatable final formatting pass for Markdown created by people, agents, or other skills.
• Uses supporting reference files for deeper formatting rules and normalization guidance.

How It Works

1. Reads the Markdown file and identifies its current structure.
2. Preserves important facts, requirements, decisions, and content.
3. Applies the relevant formatting and structural rules.
4. Normalizes headings, lists, syntax, spacing, and layout.
5. Reviews the result for consistency and accidental information loss.
6. Produces a cleaner Markdown file without changing what the document is meant to say.

Package Contents

The skill package contains the main SKILL.md file together with a references/ directory containing the supporting formatting rules, syntax guidance, document profiles, context rules, and normalization checks referenced by the skill. Keep the folder structure intact so references from SKILL.md continue to work correctly.

Requirements

• An AI agent or environment that can read and work with Markdown files.
• Access to the Markdown files that need to be reviewed or formatted.
• No specific programming language or software framework is required.

Frameworks & Tools

Designed for Markdown-based agent workflows and repositories. It can be used with Agent Skills, technical documentation, READMEs, architecture specifications, project guides, and general Markdown files.

Why Use This Instead of Prompting It Yourself

A generic request to "clean up this Markdown" can produce different results each time and may accidentally rewrite content. MD Design System gives the agent a repeatable formatting contract that focuses on consistency while preserving the meaning of the original document.