Skillzwave Logo
Skillzwave

markdown

1 stars
88
B

Transform AI markdown generation to be 100% markdownlint-compliant. Use this skill whenever generating messages containing markdown, generating or editing markdown files (.md) for technical documentation, README files, guides, tutorials, or any GFM content requiring clean, professional presentation.

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 →
skilz install RedondoK/claude-md-skill/markdown
skilz install RedondoK/claude-md-skill/markdown --agent opencode
skilz install RedondoK/claude-md-skill/markdown --agent codex
skilz install RedondoK/claude-md-skill/markdown --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
Download Agent Skill ZIP

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

1. Clone the repository:
git clone https://github.com/RedondoK/claude-md-skill
2. Copy the agent skill directory:
cp -r claude-md-skill/markdown ~/.claude/skills/
View on GitHub

Need detailed installation help? Check our platform-specific guides:

Claude Desktop Guide Claude Code Guide Troubleshooting

Related Agentic Skills

notion-uploader-downloader

by SpillwaveSolutions

Bidirectional sync between Markdown and Notion. Upload .md files with images to Notion pages/databases, append to existing pages, or download Notio...

87
TECHmarkdown
Marketplace

markdown-quality

by racurry

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

82
markdown
Marketplace

markdown-linter-fixer

by s2005

Systematically fix linting issues in markdown files using markdownlint-cli2. This skill should be used when needing to scan, diagnose, and fix mark...

78
markdown
Marketplace

markdown-quality

by bostonaholic

Use when creating or editing any markdown file (.md) - ensures consistent formatting and zero linting violations through mandatory validation

75
markdown
Marketplace

Agentic Skill Details

Owner
RedondoK (GitHub)
Repository
claude-md-skill
Stars
1
Type
Non-Technical
Meta-Domain
productivity
Primary Domain
markdown
Market Score
88
Agentic Skill Grades →

Agent Skill Grade

B
Score: 88/100 Click to see breakdown

Score Breakdown

Spec Compliance
12/15
PDA Architecture
27/30
Ease of Use
22/25
Writing Style
9/10
Utility
18/20

Areas to Improve

  • Description needs trigger phrases
  • Reference files lack TOC
  • Redundant Remember section

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 skill and wanted to share some thoughts.

Links:

The TL;DR

You're at 88/100, solid B grade. This is graded against Anthropic's skill best practices. Your strongest area is Progressive Disclosure Architecture (27/30) — the layering between your concise SKILL.md and the three reference files is really well done. Weakest is Spec Compliance (12/15), mainly around metadata details.

What's Working Well

  • Architecture is chef's kiss — 419-line SKILL.md paired with three focused references (complete-rules.md, edge-cases.md, examples.md). You're not making users dig through 1000+ lines of rules upfront. That's exactly what PDA means.
  • Pre/post generation checklists — Those numbered validation steps give users clear entry and exit criteria. The "Run: markdownlint filename.md" command is perfect for feedback loops.
  • Comprehensive examples — correct/incorrect pattern pairs throughout make this actually useful instead of theoretical. The quick patterns section with copy-paste templates is bang for your buck.
  • Solves a real problem — markdownlint compliance from Claude on first try is a genuine pain point. Your skill addresses it directly.

The Big One: Missing Trigger Phrases

Your description in the frontmatter has zero trigger phrases. Right now it reads like marketing copy rather than actionable invocation guidance. This hurts discoverability and spec compliance.

Current: description: Transform AI markdown generation to be 100% markdownlint-compliant...

Fix: Add trigger phrases like you'd actually invoke this:

description: Performs markdown operations. Use when asked to "markdown", "generate markdown", "create markdown", "markdown guide", or "markdown help".

This is a...

Browse Category

More productivity Agentic Skills

Report Security Issue

Found a security vulnerability in this agent skill?