Can this skill fix errors automatically?

Yes, it uses the --fix flag to automatically resolve common issues like trailing spaces and missing blank lines, and provides intelligent manual fixes for structural errors.

Does it support custom rules?

Yes, all rules, ignores, and custom settings can be configured in a central .markdownlint-cli2.jsonc file which acts as the single source of truth.

What is markdownlint-cli2?

It is a fast, flexible, and configuration-based CLI tool used to identify and fix style and syntax issues in Markdown files.

Is it compatible with CI/CD?

Absolutely. This skill includes specific guidance for integrating the same linting rules into GitHub Actions to ensure consistent quality in pull requests.

Markdown Linting & Quality

Name: Markdown Linting & Quality
Author: melodic-software

bymelodic-software

•

学習とドキュメンテーション

Validates and automatically fixes Markdown files to ensure high documentation standards and consistency using industry-standard tooling.

概要

The Markdown Linting skill empowers Claude to maintain professional documentation standards by integrating the markdownlint-cli2 engine directly into the development workflow. It provides automated detection and remediation of formatting issues, structural errors, and style violations across entire repositories. Beyond simple syntax checks, the skill offers intelligent strategies for complex fixes like heading hierarchies and duplicate anchors, while ensuring a unified configuration across local CLI environments, VS Code extensions, and GitHub Actions CI/CD pipelines.

主な機能

Automated linting and fixing using markdownlint-cli2
Step-by-step setup for VS Code and GitHub Actions integration
Unified configuration management via .markdownlint-cli2.jsonc
Strict enforcement of MD0XX accessibility and readability rules
Intelligent context-aware fixing for complex structural errors
1 GitHub stars

ユースケース

Enforcing consistent documentation styles across large team repositories
Automating the cleanup of legacy Markdown files and broken link references
Standardizing documentation quality checks in CI/CD pipelines

概要

主な機能

Automated linting and fixing using markdownlint-cli2
Step-by-step setup for VS Code and GitHub Actions integration
Unified configuration management via .markdownlint-cli2.jsonc
Strict enforcement of MD0XX accessibility and readability rules
Intelligent context-aware fixing for complex structural errors
1 GitHub stars

ユースケース

Enforcing consistent documentation styles across large team repositories
Automating the cleanup of legacy Markdown files and broken link references
Standardizing documentation quality checks in CI/CD pipelines