jimweller/md-lint
dotfiles/claude-code/skills/md-lint/SKILL.md
Format and lint markdown files using prettier and markdownlint-cli2. Always use after writing markdown files (*.md) intended for humans.
tools
Updated Apr 19, 2026
$ install --global
skillsauthnpx skillsauth add jimweller/dotfiles md-lintInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 19, 2026, 5:01 AM4.7s1 file scanned
SKILL.md
- name:
- md-lint
- description:
- Format and lint markdown files using prettier and markdownlint-cli2. Always use after writing markdown files (*.md) intended for humans.
- context:
- fork
<!-- markdownlint-disable-file MD041 -->
STARTER_CHARACTER = 🔏
Markdown Lint
Format and lint markdown files with auto-fix enabled.
Usage
if $ARGUMENTS is empty, process all markdown files in the repository if $ARGUMENTS is not empty, process only the markdown files specified as arguments
To fix all markdown files in the repository, run from the git root:
PROJECT_ROOT=$(git rev-parse --show-toplevel)
cd "$PROJECT_ROOT"
prettier --config ~/.prettierrc --write "**/*.md" --ignore-path .gitignore && markdownlint-cli2 --config ~/.config/markdownlint/.markdownlint-cli2.jsonc --fix "**/*.md"
To fix a specific file (can run from any directory):
PROJECT_ROOT=$(git rev-parse --show-toplevel)
prettier --config ~/.prettierrc --write "path/to/file.md" && markdownlint-cli2 --config ~/.config/markdownlint/.markdownlint-cli2.jsonc --fix "path/to/file.md"
Notes
- Some markdownlint rules (like MD060) are not auto-fixable, but prettier handles them
- If an error cannot be fixed automatically by prettier, ask the user if you should fix them manually for the user.
Related Skills
jimweller/transcript-search
testing
VerifiedTrustedCommunity
Search saved session transcripts for past decisions, actions, errors, and context that has left the current conversation window.
1SKILL.mdUpdated Apr 22, 2026
jimweller/prd-review
data-ai
VerifiedTrustedCommunity
Review a PRD for defects via Claude opus subagent.
SKILL.mdUpdated Apr 29, 2026
jimweller/md-syntax
development
VerifiedTrustedCommunity
Markdown authoring guidelines for formatting, code blocks, and structure. Use when writing or editing markdown files.
SKILL.mdUpdated Apr 29, 2026
jimweller/configs/claude-code/skills/md-style
development
VerifiedTrustedCommunity
--- name: md-style description: README style guide for concise, direct documentation. Use when writing or editing README files. ß--- <!-- markdownlint-disable-file MD041 --> # README Style Guide Write concise, direct README files for experienced engineers. ## Principles - **No fluff** - Skip tables of contents, verbose explanations, development history - **No roadmaps** - Document current state only, not plans or decisions. Readme is an engineering specification. Not a project plan or chan
SKILL.mdUpdated Apr 29, 2026