Markdown Linter - {{arguments}} — Documentation skill for Claude Code
Use the markdown-linter-fixer skill to check or fix markdown linting issues.
How to install Markdown Linter - {{arguments}}
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open s2005/markdown-linter-fixer-skill and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Markdown Linter - {{arguments}} does
Use the `markdown-linter-fixer` skill to check or fix markdown linting issues. **Command format:** `/markdown-linter-fixer:mdlinter [mode] [scope]` **Arguments:** - Mode (optional): `{{ARGUMENTS}}` -
Alternatives in Documentation
- Repo Recap — Generate a structured recap of the repository state: open PRs, open issues, recent releases, and executive sum 11.9k ★
- Documentation Sync — Check if documentation matches the current code state 5.8k ★
- Ars Format Convert — ARS academic-paper format-convert mode — convert to LaTeX / DOCX / PDF / Markdown 4.5k ★
README
description: Check or fix markdown linting issues with optional scope
Markdown Linter - {{ARGUMENTS}}
Use the `markdown-linter-fixer` skill to check or fix markdown linting issues.
**Command format:** `/markdown-linter-fixer:mdlinter [mode] [scope]`
**Arguments:**
Mode (optional): `{{ARGUMENTS}}`
- First argument can be either
checkorfix check- scan and report issues WITHOUT making changes (DEFAULT if not specified or invalid)fix- scan and automatically fix all issues- Safety default: If no mode is provided or an invalid mode is given, defaults to
checkmode
- First argument can be either
Scope (optional):
- Can be specified as second argument (or first if mode is omitted)
- Can be: a specific file, multiple files (space-separated), a folder, or a glob pattern
- If not provided, operates on ALL markdown files in the project
**Examples:**
/markdown-linter-fixer:mdlinter- check all files (default mode)/markdown-linter-fixer:mdlinter check- explicitly check all files/markdown-linter-fixer:mdlinter fix- fix all files/markdown-linter-fixer:mdlinter README.md- check only README.md (default mode)/markdown-linter-fixer:mdlinter check README.md- explicitly check only README.md/markdown-linter-fixer:mdlinter fix docs/- fix all files in docs folder/markdown-linter-fixer:mdlinter check README.md CONTRIBUTING.md- check specific files
**Workflow based on mode:**
**IMPORTANT**: If mode is not specified or is invalid, always use CHECK mode as the safe default.
**For CHECK mode:**
- Verify markdownlint-cli2 installation
- Check for existing configuration files
- Run diagnostic scans on the specified scope
- Categorize and analyze all errors by type
- Generate comprehensive report
- IMPORTANT: Do NOT execute auto-fix (--fix flag)
- Do NOT make any manual fixes to files
- ONLY scan and report the issues found
**For FIX mode:**
- Verify markdownlint-cli2 installation
- Check/create configuration files
- Run diagnostic scans on the specified scope
- Apply automatic fixes using --fix flag
- Handle any remaining manual fixes (especially MD029 issues)
- Verify all issues are resolved
- Provide comprehensive summary report
**Report should include:**
- Total files scanned
- All errors found by type (MD001, MD029, MD032, etc.)
- File names and line numbers for each error
- Count of each error type
- Which errors are auto-fixable vs require manual intervention
Related Skills
Fix Markdown Linting
Fix markdown linting errors across repository using adaptive parallel subagents
Typo
Fix typos and grammar issues in @README.md
Maintainer Work
Take a reported issue through the maintenance loop — confirm, verify against source-of-truth, fix, PR into dev
Okf Check
Validate an OKF knowledge bundle (ours or a third-party clone) against the Open Knowledge Format v0.1 conforma
Intelligent Lint
Run intelligent markdown linting with autonomous agent analysis
Validate Agents
Use the markdown-linter agent to validate all agent files in the repository.
Related Agents
Pre Commit Linter
Use this agent when the user wants to commit code using Claude. It should be triggered automatically before an
Issue Analyzer Fixer
Use this agent when you encounter a bug, error, failing test, or code issue that needs both diagnosis and reme
Quality Checker
Runs the full quality pipeline (type-checking, linting, tests) and returns a concise summary of issues. Use af