doc-validate-markdown

Validate markdown files for formatting, links, and style compliance using markdownlint-cli2.

18|5|Updated Nov 3, 2025
One-click install
npx skills add https://github.com/HomericIntelligence/ProjectOdyssey --skill doc-validate-markdown-homericintelligence
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-validate-markdown
Source: https://github.com/HomericIntelligence/ProjectOdyssey/tree/main/.claude/skills/doc-validate-markdown
Command: npx skills add https://github.com/HomericIntelligence/ProjectOdyssey --skill doc-validate-markdown-homericintelligence

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires markdownlint-cli2, and includes references (resource) components.

What problem does it solve?

This Skill automates the tedious process of checking markdown files for formatting errors, broken links, and style inconsistencies, ensuring your documentation is professional and error-free.

Core Features & Use Cases

  • Automated Linting: Applies markdownlint-cli2 to enforce style guides and catch common markdown mistakes.
  • Error Identification: Pinpoints specific issues like missing language tags in code blocks, incorrect spacing, and lines exceeding length limits.
  • Use Case: Before committing a large documentation update, run this skill to automatically verify that all markdown files adhere to project standards, preventing CI failures and maintaining a clean codebase.

Quick Start

Run the doc-validate-markdown skill to check all markdown files in the current directory for linting errors.

Frequently Asked Questions about doc-validate-markdown

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

FAQPage Schema
How do I validate markdown files for formatting and style consistency?

You can validate markdown files by running markdownlint-cli2 to check for formatting errors, broken links, and style deviations. This process applies linting rules to identify issues like missing code block language tags and incorrect spacing.

How do I check markdown documentation for errors before a git commit?

Run a markdown validation check before committing to automatically verify all markdown files adhere to project standards. This pre-commit check prevents CI failures by pinpointing stylistic deviations and formatting inconsistencies.

What markdown linting issues does markdownlint-cli2 catch?

Markdownlint-cli2 catches common markdown mistakes including missing language tags in code blocks, incorrect spacing, and lines exceeding length limits. It enforces style guides to ensure documentation remains professional and error-free.

Do I need npx to run markdownlint-cli2 for documentation validation?

Yes, executing markdownlint-cli2 requires npx to run the linter and apply validation rules. This allows you to identify stylistic deviations without globally installing the package.

Can I use markdown validation for ongoing documentation maintenance?

Yes, markdown validation is designed for documentation maintenance and pre-commit checks within software development projects. It automates the tedious process of checking files to maintain a clean codebase.

Why do my markdown files fail CI checks for style guide compliance?

Markdown files fail CI checks due to formatting errors, broken links, and style inconsistencies that violate project standards. Running markdownlint-cli2 identifies these specific stylistic deviations so you can fix them before integration.