markdown-quality

Interpretive guidance for applying markdownlint rules using our opinionated configuration. Use when creating or editing markdown files, configuring markdownlint, troubleshooting linting issues, or reviewing markdown quality.

Marketplace

Also in: json

Third-Party Agent Skill: Review the code before installing. Agent skills execute in your AI assistant's environment and can access your files. Learn more about security

Installation for Agentic Skill

View all platforms →

Claude Code (CLI) Fast

skilz install racurry/neat-little-package/markdown-quality

OpenCode (CLI) Fast

skilz install racurry/neat-little-package/markdown-quality --agent opencode

OpenAI Codex (CLI) Native

skilz install racurry/neat-little-package/markdown-quality --agent codex

Gemini CLI (Project) Project

skilz install racurry/neat-little-package/markdown-quality --agent gemini

First time? Install Skilz: pip install skilz

Works with 14 AI coding assistants

Cursor, Aider, Copilot, Windsurf, Qwen, Kimi, and more...

View All Agents

For Claude Desktop Easy

Download Agent Skill ZIP

Extract and copy to ~/.claude/skills/ then restart Claude Desktop

Manual Installation

1. Clone the repository:

git clone https://github.com/racurry/neat-little-package

2. Copy the agent skill directory:

cp -r neat-little-package/plugins/mr-sparkle/skills/markdown-quality ~/.claude/skills/

Owner: racurry (GitHub)
Repository: neat-little-package
Type: Non-Technical
Meta-Domain: productivity
Primary Domain: markdown
Market Score: 82

Agentic Skill Grades →

Agent Skill Grade

Score: 82/100 Click to see breakdown

Score Breakdown

Spec Compliance

12/15

PDA Architecture

24/30

Ease of Use

21/25

Writing Style

8/10

Utility

17/20

Areas to Improve

Missing TOC in SKILL.md
Duplicate pitfalls content
Second-person voice in troubleshooting

Recommendations

Add trigger phrases to description for discoverability
Add table of contents for files over 100 lines

Graded: 2026-01-05

Developer Feedback

I took a look at your markdown-quality skill and wanted to share some thoughts.

Links:

The TL;DR

You're at 82/100, solid B grade territory. This is based on Anthropic's skill best practices framework. Your strongest area is Utility (17/20) - the skill actually solves real markdown quality problems with opinionated, practical guidance. Weakest spot is Spec Compliance (12/15), mainly because your description could use more trigger phrases for better discoverability.

What's Working Well

Rock-solid utility design. You've nailed the problem-solving angle with clear guidance on when to bend rules vs. enforce strictness. The feedback loops are clean - lint → fix → validate pattern is intuitive.
Good Progressive Disclosure structure. You've got 4 reference files that properly defer details from SKILL.md. The separation between main content and references is thoughtful.
Excellent examples throughout. Your anti-pattern/better example pairs really show developers why the rules matter, not just what the rules are.
Solid troubleshooting guide. The Common Pitfalls and FAQ sections cover real problems developers hit.

The Big One

Your SKILL.md lacks a table of contents - it's ~390 lines jumping straight into content. For a file this size, developers can't quickly navigate to what they need. This hurts your Progressive Disclosure score because readers have to scroll through everything.

The fix: Add a TOC after the frontmatter with links to major sections (Getting Started, Configuration, Common Pitfalls, Troubleshooting, etc.). This is a quick win that gives you +1-2 points toward better navigation signals.

markdown-quality

Installation for Agentic Skill

Related Agentic Skills

markdown

notion-uploader-downloader

markdown-linter-fixer