S2005 Markdown Linter Fixer Skill
s2005-markdown-linter-fixer-skill is a Claude Code plugin for the Ship phase that systematically fixes markdownlint-cli2 issues in markdown files via an agent skill.
by s2005 · github.com/s2005/markdown-linter-fixer-skill
Install when markdown in your repo fails markdownlint-cli2 and you want Claude to diagnose and fix rules like MD029 systematically.
Add it to Claude Code
Install the plugin in Claude Code. One command, paste-ready.
/plugin install s2005-markdown-linter-fixer-skill@s2005/markdown-linter-fixer-skillBuilt to be called by your agent
Skillselion is itself an MCP server. Your agent can pull this entry and a paste-ready install config straight from the API - no copy-paste.
Retrieve this entry with skillselion.get_details("plugin:s2005/markdown-linter-fixer-skill") and the paste-ready config with skillselion.get_install_config("plugin:s2005/markdown-linter-fixer-skill").
What it does
The s2005 Markdown Linter Fixer Skill is a Claude Code plugin that turns markdownlint-cli2 output into an agent-guided repair loop for solo builders maintaining docs, skills, and READMEs. You install it when lint noise blocks merges or when ordered-list and formatting rules keep breaking CI. The skill emphasizes systematic diagnosis, targeted fixes, and verification rather than hand-editing every violation. It sits on the ship phase review shelf because its payoff is merge-ready, publish-ready markdown, though it is equally useful while writing documentation during build. It is a narrow task tool—not a full docs generator or release manager—so confidence is high for its stated scope. The bundle contains one plugin from s2005/markdown-linter-fixer-skill with community catalog placement and modest GitHub traction (8 stars). Pair it with your existing markdownlint config and CLI install in the project.
Highlights
- Systematic markdown fixes driven by markdownlint-cli2 diagnostics
- Structured workflows to diagnose, fix, and verify lint issues in .md files
- Special focus on common rules including MD029 ordered-list numbering
- Agent skill packaged as a single Claude Code plugin (plugin count: 1)
- Formatting consistency for docs-heavy solo-builder repos
Why builders use it
Markdownlint failures in skills and docs waste solo-builder time on repetitive MD029-style fixes and inconsistent formatting across many files.
After install, your agent can run structured diagnose-fix-verify workflows so markdown files align with markdownlint-cli2 before review or release.
At a glance
- Type - Plugin in Development Tools.
- Adoption - 0 installs, 8 stars, 0 votes.
FAQ
Who is s2005-markdown-linter-fixer-skill for?
Solo developers and skill authors who use markdownlint-cli2 and want Claude Code to fix formatting and rule violations in markdown files consistently.
When should I use s2005-markdown-linter-fixer-skill?
Use it after lint reports errors or before merging doc-heavy PRs—especially for ordered lists (MD029) and repo-wide markdown hygiene.
How do I add s2005-markdown-linter-fixer-skill to my agent?
Add the plugin from the Skillselion catalog to Claude Code, ensure markdownlint-cli2 is available in your project, then invoke the skill against failing markdown paths.
Comments
Share how you use s2005-markdown-linter-fixer-skill, gotchas, or tips for other indie builders.
No comments yet - be the first to share how you use it.