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.
100
Does it follow best practices?
Validation for skill structure
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that hits all the key criteria. It specifies the exact tool and capability, provides comprehensive trigger terms that users would naturally say, explicitly addresses both what and when, and proactively distinguishes itself from similar skills (Jina for web content). The description is concise yet information-dense.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Convert local documents to Markdown', specifies the tool 'Microsoft's markitdown CLI', and enumerates supported formats (PDF, Word, Excel, PowerPoint, images with OCR, audio). Also provides comparative guidance about Jina for web URLs. | 3 / 3 |
Completeness | Clearly answers both what ('Convert local documents to Markdown using Microsoft's markitdown CLI') and when ('Triggers on: convert to markdown, read PDF, parse document...'). The explicit 'Triggers on:' clause provides clear guidance for skill selection. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'convert to markdown', 'read PDF', 'parse document', 'extract text from', plus file extensions 'docx, xlsx, pptx', and 'OCR image', 'local file'. These are terms users would naturally use when needing this functionality. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with clear niche: local document conversion to Markdown using a specific tool. Explicitly differentiates from web-fetching tools ('Jina is faster for web'), reducing conflict risk with URL-handling skills. The 'local file' trigger further clarifies scope. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an excellent skill file that exemplifies good practices: concise tables for decision-making and format support, executable examples throughout, and clear guidance on when to use alternatives. The content respects Claude's intelligence while providing all necessary actionable information in a well-structured format.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient, using tables to compress information effectively. No unnecessary explanations of what file formats are or how CLI tools work - assumes Claude's competence throughout. | 3 / 3 |
Actionability | Provides fully executable, copy-paste ready bash commands for every use case. Clear examples with actual file extensions and output redirection patterns that can be used immediately. | 3 / 3 |
Workflow Clarity | This is a simple, single-purpose skill (run CLI command, get output). The single action is unambiguous with no multi-step process requiring validation checkpoints. The decision table at the top clearly guides when to use vs. alternatives. | 3 / 3 |
Progressive Disclosure | Well-organized with clear sections progressing from decision criteria to basic usage to examples. At ~80 lines with no need for external references, the content is appropriately self-contained with logical section flow. | 3 / 3 |
Total | 12 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Reviewed
Table of Contents
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.