Does it respect my project's existing linting rules?

Yes, it is designed to use your project's .prettierrc and .markdownlint-cli2.jsonc configuration files to ensure it adheres to your specific style guides.

Can I run this on a single file instead of the whole project?

Absolutely. You can provide specific file paths as arguments to process individual files, or run it without arguments to lint the entire repository.

Does md-lint require Prettier and markdownlint-cli2 to be installed?

Yes, this skill executes shell commands that rely on Prettier and markdownlint-cli2 being available in your environment, utilizing your local configuration files.

Is this skill suitable for non-technical documentation?

Yes, it is specifically intended for any Markdown files meant for human consumption, ensuring they are well-formatted and easy to read.

What happens if a Markdown error cannot be fixed automatically?

For rules that are not auto-fixable, such as complex list nesting issues, the skill will notify you and offer to help you resolve the formatting manually.

Markdown Linter & Formatter

Name: Markdown Linter & Formatter
Author: jimweller

byjimweller

0•

内容管理

Standardizes and repairs Markdown files using Prettier and markdownlint-cli2 to ensure professional, readable documentation.

The md-lint skill automates the process of maintaining high-quality Markdown documentation within any repository. By combining the formatting power of Prettier with the strict structural rules of markdownlint-cli2, it detects syntax errors, inconsistent styling, and accessibility issues. It intelligently handles auto-fixable errors and prompts users for manual intervention when necessary, making it an essential tool for developers and technical writers who want to maintain professional-grade READMEs and documentation sets with minimal effort.

主要功能

01Interactive prompts for resolving complex, non-fixable linting issues

02Automated code formatting using project-specific Prettier configurations

03Support for both single-file targeting and full repository scanning

04Intelligent auto-fixing for common syntax and style violations

050 GitHub stars

06Comprehensive structural linting with markdownlint-cli2 rulesets

使用场景

01Modernizing and standardizing legacy documentation files during repository audits

02Automating the cleanup of Markdown files before committing to version control

03Enforcing consistent documentation styles across collaborative team repositories

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

Download Skill