What problem does it solve?
Many repositories accumulate inconsistent Markdown formatting that hurts readability, generates noisy diffs, and fails CI checks. This skill validates documentation and README files against a stable rule set and prevents style regressions before they reach review.
Core Features & Use Cases
- Installation check & remediation: Detects whether markdownlint-cli is available and attempts to install via npm with clear remediation steps if installation fails.
- Config detection and sensible defaults: Uses project-specific markdownlint configuration when present or a minimal default config to ensure predictable behavior.
- Validation and auto-fix: Runs lint checks across files, reports rule-level failures with actionable fixes, and supports an optional auto-fix mode for common issues.
- Use Case: Integrate into local development or CI to validate docs, enforce team style, and reduce back-and-forth in PR reviews.
Quick Start
Run the markdownlint skill to validate and optionally auto-fix all Markdown files in the repository.