What happens if a linting error cannot be fixed automatically?

For rules like MD060 that require manual intervention, Claude will notify you of the error and offer to help you rewrite the section manually.

Can I target specific files instead of the whole repository?

Absolutely. You can provide specific file paths as arguments, or run the skill without arguments to process all Markdown files from the repository root.

Does this skill require external configurations?

The skill is designed to work with standard .prettierrc and .markdownlint-cli2.jsonc configuration files found in your environment or repository.

Does this skill support auto-fixing for Markdown errors?

Yes, the skill leverages the auto-fix capabilities of both Prettier and markdownlint-cli2 to automatically resolve most styling and structural issues.

Markdown Linter & Formatter

Name: Markdown Linter & Formatter
Author: jimweller

byjimweller

0•

開発者ツール

Standardizes and corrects Markdown documentation using Prettier and markdownlint-cli2 to ensure consistent, production-grade formatting.

The md-lint skill automates the maintenance of high-quality Markdown files by integrating Prettier and markdownlint-cli2 directly into the Claude Code workflow. It streamlines documentation management by identifying styling inconsistencies and structural errors, applying automatic fixes for most common issues, and flagging complex rules for manual review. This skill is essential for teams looking to enforce documentation standards across READMEs, technical guides, and repository wikis without manual overhead.

主な機能

01Automated Markdown formatting via Prettier integration

02Smart auto-fix capabilities for rapid error resolution

03Interactive manual-fix prompts for non-automatable rules

04Flexible scoping for repository-wide or file-specific processing

050 GitHub stars

06Comprehensive linting using markdownlint-cli2 standards

ユースケース

01Enforcing consistent documentation styles across large multi-contributor repositories

02Batch processing legacy Markdown files to meet modern formatting standards

03Pre-commit cleanup of README files and technical documentation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jimweller/davit-dataops-dotfiles md-lint

For use in Claude.ai and ChatGPT

主な機能

01Automated Markdown formatting via Prettier integration

02Smart auto-fix capabilities for rapid error resolution

03Interactive manual-fix prompts for non-automatable rules

04Flexible scoping for repository-wide or file-specific processing

050 GitHub stars

06Comprehensive linting using markdownlint-cli2 standards

ユースケース

01Enforcing consistent documentation styles across large multi-contributor repositories

02Batch processing legacy Markdown files to meet modern formatting standards

03Pre-commit cleanup of README files and technical documentation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jimweller/davit-dataops-dotfiles md-lint

For use in Claude.ai and ChatGPT