Agent skill · writing content · aiskillstore
markdown
Markdown linting and automated fixing using markdownlint-cli2. Use when Claude needs to: (1) Check markdown files for style issues, (2) Fix markdown formatting problems, (3) Ensure markdown follows best practices, (4) Validate markdown documents, or (5) Apply consistent markdown styling
Why this skill is useful
Adds specific commands and workflows for using markdownlint-cli2 that the AI wouldn't reliably generate on its own.
What it needs
Requires markdownlint-cli2 installed locally. About 3k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Markdown Lint Automated markdown validation and fixing using markdownlint-cli2. Workflow Overview Expected results: Auto-fix resolves 70-90% of issues. Remaining 3-5 issues require manual correction. Basic Commands File Paths Manual Fixes Required Auto-fix cannot resolve these issues - they need Claude's judgment: MD025 - Multiple H1 Headers Why: Requires understanding document hierarchy Fix: Convert extra H1s to appropriate level MD036 - Emphasis as Header Why: Requires determining author intent Fix: Replace bold/italic with proper header MD013 - Line Too Long Why: Requires deciding where to break content Fix: Wrap at natural points (spaces, punctuation) Exception: URLs typically exempt MD041 - Missing First Line Header Why: Requires structural decision Fix: Add H1 at start or restructure Execution Pattern For Uploaded Files For New Content Configuration Create .markdownlint.json to customize rules: Common adjustments: "MD013": false - Disable line length checking "MD013": { "linelength": 120 } - Increase limit to 120 "MD013": { "codeblocks": false } - Exclude code blocks "MD033": false - Allow HTML "MD041": false - Don't require first line header Config file search order: 1. .markdownlint-cli2.jsonc 2. .markdownlint-cli2.yaml 3. .markdownlint.jsonc / .markdownlint.json 4. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/markdown