markitdown

Convert local documents to Markdown using Microsoft's markitdown CLI. Best for: PDF, Word, Excel, PowerPoint, images (OCR), audio. Can fetch URLs but Jina is faster for web. Triggers on: convert to markdown, read PDF, parse document, extract text from, docx, xlsx, pptx, OCR image, local file.

2.37x

Quality

88%

Does it follow best practices?

Impact

83%

2.37x

Average score across 3 eval scenarios

Securityby

Low

Low-risk findings worth noting

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, well-structured CLI skill with copy-paste commands and a clear selection table. The main weakness is redundancy between the Basic Usage/Examples and When-to-Use/Comparison sections, which inflates tokens without adding capability.

Suggestions

Merge the 'Basic Usage' and 'Examples' code blocks into one section; the current Examples block largely restates Basic Usage commands.

Consolidate the 'When to Use' and 'Comparison with Alternatives' tables into a single table to remove duplicated markitdown-vs-Jina-vs-Firecrawl content.

Consider trimming the 'Benchmarked Performance' URL table or folding its verdict into the consolidated comparison table, since the skill's primary purpose is local files.

Dimension	Reasoning	Score
Conciseness	Mostly efficient (tables/code, no concept padding) but contains real redundancy: the 'Basic Usage' and 'Examples' code blocks overlap heavily, and the 'When to Use' and 'Comparison with Alternatives' tables cover the same markitdown-vs-alternatives ground.	3 / 5
Actionability	Fully executable copy-paste commands covering every common case — 'markitdown document.pdf', '> document.md' redirection, and per-format examples for PDF, Word, Excel, PPT, OCR, and audio.	5 / 5
Workflow Clarity	Single-action skill (run markitdown on a file) with an unambiguous core action and a clear 'When to Use' decision table; read-only conversion requires no validation checkpoints, so the simple-skill exception applies.	5 / 5
Progressive Disclosure	Well-organized single-file structure with clear section headers and no nested references, but the duplicated examples and overlapping comparison tables are an organization gap that consolidation would close.	4 / 5
	Total	17 / 20 Passed

Description

96%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, concrete description with explicit trigger guidance and broad format coverage written in third person. Minor overlap risk from a few generic trigger terms keeps it just below a perfect distinctiveness score.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete capabilities across comprehensive format coverage — 'Convert local documents to Markdown', 'fetch URLs', 'images (OCR)', 'audio' — matching the comprehensive-actions anchor.	5 / 5
Completeness	Explicitly states both what ('Convert local documents to Markdown using Microsoft's markitdown CLI') and when ('Triggers on: ...'), with concrete trigger phrases.	5 / 5
Trigger Term Quality	'Triggers on: convert to markdown, read PDF, parse document, extract text from, docx, xlsx, pptx, OCR image, local file' covers natural phrases plus file extensions and synonyms.	5 / 5
Distinctiveness Conflict Risk	Clear niche (local files via markitdown CLI) and explicit steer-away from Jina/Firecrawl, but generic triggers like 'parse document' and 'extract text from' carry minor overlap risk with format-specific skills.	4 / 5
	Total	19 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: NeverSight/skills_feed
Path: data/skills-md/0xdarkmatter/claude-mods/markitdown/SKILL.md
Commit: 2f57aec

Reviewed: about 23 hours ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.