Skillzwave Logo
Skillzwave

markdown-tools

80
B

Converts documents to markdown (PDFs, Word docs, PowerPoint, Confluence exports) with Windows/WSL path handling. Activates when converting .doc/.docx/PDF/PPTX files to markdown, processing Confluence exports, handling Windows/WSL path conversions, or working with markitdown utility.

Marketplace

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 daymade/claude-code-skills/markdown-tools
skilz install daymade/claude-code-skills/markdown-tools --agent opencode
skilz install daymade/claude-code-skills/markdown-tools --agent codex
skilz install daymade/claude-code-skills/markdown-tools --agent gemini

First time? Install Skilz: pip install skilz

Works with 22+ 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/daymade/claude-code-skills
2. Copy the agent skill directory:
cp -r claude-code-skills/markdown-tools ~/.claude/skills/
View on GitHub

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

Claude Desktop Guide Claude Code Guide Troubleshooting

Related Agentic Skills

confluence

by SpillwaveSolutions

Manage Confluence documentation with downloads, uploads, conversions, and diagrams. Use when asked to "download Confluence pages", "upload to Confl...

89
general
Marketplace

confluence

by SpillwaveSolutions

Manage Confluence documentation with downloads, uploads, conversions, and diagrams. Use when asked to "download Confluence pages", "upload to Confl...

89
general
Marketplace

plantuml

by SpillwaveSolutions

Generate PlantUML diagrams from text descriptions and convert them to PNG/SVG images. Use when asked to "create a diagram", "generate PlantUML", "c...

88
general
Marketplace

markdown

by 46ki75

> Markdown linting and automated fixing using markdownlint-cli2. Use when Claude needs to: (1) Check markdown files for style issues, (2) Fix markd...

80
general
Marketplace

Agentic Skill Details

Owner
daymade (GitHub)
Repository
claude-code-skills
Type
Non-Technical
Meta-Domain
general
Primary Domain
general
Sub-Domain
markdown documentation skill
Market Score
80
Agentic Skill Grades →

Agent Skill Grade

B
Score: 80/100 Click to see breakdown

Score Breakdown

Spec Compliance
11/15
PDA Architecture
24/30
Ease of Use
21/25
Writing Style
8/10
Utility
16/20

Areas to Improve

  • Description needs trigger phrases
  • Missing TOC in long reference file
  • Vague cleanup instructions

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

Links:

The TL;DR

You're at 80/100, solid B-grade territory. This skill covers a real gap in document-to-markdown conversion (especially with WSL path handling), which is genuinely useful. Your strongest area is Ease of Use (21/25)—the metadata and trigger coverage are strong. The weakest spot is Spec Compliance (11/15), mainly because you're missing trigger phrases in the description.

What's Working Well

  • Metadata is thorough: Your description includes specific document types (PDFs, Word docs, PowerPoint, Confluence exports) and even mentions WSL path handling. That specificity helps activation.
  • Progressive disclosure structure: SKILL.md gives a quick overview while conversion-examples.md handles 347 lines of reference material. That separation works.
  • Practical problem-solving: WSL path conversion is a nice touch—it's addressing a real Windows developer pain point that generic tools miss.
  • Examples are grounded: The command examples show real workflow patterns, not just syntax.

The Big One: Add Trigger Phrases to Description

Your description currently reads: "Converts documents to markdown (PDFs, Word docs, PowerPoint, Confluence exports)..." But it doesn't tell Claude when to invoke this skill.

Why it matters: Without explicit trigger phrases, the skill relies on fuzzy matching. A developer asking "convert my PDF to markdown" might not surface your skill at all.

The fix (in SKILL.md frontmatter):

description: "Converts documents to markdown (PDFs, Word docs, PowerPoint, Confluence exports) with Windows/WSL path support. Use when asked to 'convert document to markdown', 'markdo...

Browse Category

More general Agentic Skills

Report Security Issue

Found a security vulnerability in this agent skill?