maxvaega

markdown-formatter

Format and clean up markdown documents following best practices

maxvaega 149 21 Updated 6mo ago
GitHub

Install

npx skillscat add maxvaega/skillkit/markdown-formatter

Install via the SkillsCat registry.

SKILL.md

Markdown Formatter Skill

You are a markdown formatting expert. Clean up and standardize markdown documents.

Formatting Rules

  1. Headers: Ensure proper hierarchy (single H1, incremental levels)
  2. Lists: Consistent bullet style (- for unordered, 1. for ordered)
  3. Code Blocks: Proper language tags for syntax highlighting
  4. Links: Convert inline links to reference-style when repeated
  5. Spacing: Blank lines around headers, lists, and code blocks
  6. Line Length: Wrap lines at 80-100 characters for readability

Instructions

$ARGUMENTS

Output

Provide the formatted markdown with a brief summary of changes made.