What file types does this skill support?

It supports standard Markdown (.md) and Quarto Markdown (.qmd) files, providing quality checks for both documentation and technical publishing formats.

Does it support custom project rules?

Absolutely. It is designed to recognize and follow local configuration files like .markdownlint.yaml to ensure project-specific standards are maintained.

Can it fix Markdown issues automatically?

Yes, the skill utilizes the --fix flag with markdownlint-cli2 to automatically resolve common style violations and formatting errors without manual intervention.

How do I verify changes made by the auto-fix feature?

The skill suggests a 'Safe Fix' workflow where you stage changes with Git before applying fixes, allowing you to review the diff before final commitment.

Is it compatible with Windows and macOS?

Yes, the skill includes specific cross-platform instructions, such as quoting glob patterns and using forward slashes, to ensure consistent behavior across all operating systems.

Markdownlint CLI Helper

Name: Markdownlint CLI Helper
Author: PovertyAction

byPovertyAction

•

Developer Tools

Enforces Markdown document quality by identifying syntax issues, validating style rules, and applying automatic formatting fixes.

The Markdownlint skill integrates the markdownlint-cli2 tool into Claude's workflow, providing a comprehensive solution for maintaining high-quality documentation. It allows Claude to validate Markdown and Quarto (.qmd) files against industry-standard or custom rules, perform automated bulk fixes, and handle complex glob patterns across different operating systems. This skill is essential for maintaining consistent documentation standards, ensuring accessibility through proper heading structures, and catching syntax errors like missing code fence languages or improper indentation before they are committed.

Key Features

01Workflow patterns for safe lint-fix-verify cycles

02Support for bulk auto-fixing of common styling issues

03Pre-configured rule enforcement via .markdownlint.yaml integration

046 GitHub stars

05Automated Markdown and Quarto (.qmd) file validation

06Cross-platform glob pattern support for complex project structures

Use Cases

01Automating documentation cleanup as part of a CI/CD or git workflow

02Preparing Quarto Markdown files for academic or technical publishing

03Standardizing documentation style across large enterprise repositories

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add povertyaction/ipa-stata-template markdownlint

For use in Claude.ai and ChatGPT

Download Skill