What tools does the md-lint skill use under the hood?

The skill utilizes Prettier for aesthetic code formatting and markdownlint-cli2 for enforcing structural best practices and technical linting rules.

Can it fix all Markdown errors automatically?

While it auto-fixes many issues (including those Prettier handles), some rules like MD060 may require manual intervention. The skill will notify you if a manual fix is needed.

Does it support processing specific files?

Yes, you can provide specific file paths as arguments to lint individual documents, or run it without arguments to process the entire repository.

Where should my configuration files be located?

The skill looks for ~/.prettierrc for formatting and ~/.config/markdownlint/.markdownlint-cli2.jsonc for linting rules.

Is it safe to run on large repositories?

Yes, it uses git root detection to ensure it correctly identifies your project scope and applies changes relative to the repository top-level.

Markdown Lint & Formatter

Name: Markdown Lint & Formatter
Author: jimweller

byjimweller

0•

Content Management

Automates the formatting and linting of Markdown files to ensure consistent, high-quality documentation using Prettier and markdownlint-cli2.

The md-lint skill provides a streamlined workflow for maintaining professional Markdown documentation by integrating industry-standard tools like Prettier and markdownlint-cli2. It automatically fixes common style issues, enforces consistent formatting, and identifies structural errors in .md files, making it an essential utility for developers and technical writers who want to ensure their human-readable content remains clean and standardized without manual overhead. The skill is designed to handle both repository-wide cleanups and targeted file updates, offering a smart fallback to manual correction for complex linting rules that cannot be automated.

Key Features

01Custom configuration support for localized linting rules

02Smart detection of non-fixable rules with manual correction prompts

03Automatic style formatting via Prettier integration

04Comprehensive linting and auto-fixing with markdownlint-cli2

05Support for both project-wide and specific file processing

060 GitHub stars

Use Cases

01Enforcing consistent documentation structure in multi-contributor projects

02Standardizing repository READMEs and technical guides before a pull request

03Bulk formatting legacy Markdown files to align with modern style guides

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

Key Features

01Custom configuration support for localized linting rules

02Smart detection of non-fixable rules with manual correction prompts

03Automatic style formatting via Prettier integration

04Comprehensive linting and auto-fixing with markdownlint-cli2

05Support for both project-wide and specific file processing

060 GitHub stars

Use Cases

01Enforcing consistent documentation structure in multi-contributor projects

02Standardizing repository READMEs and technical guides before a pull request

03Bulk formatting legacy Markdown files to align with modern style guides

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