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.
88
88%
Does it follow best practices?
Impact
83%
2.37xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
Quality
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 covers all key dimensions well. It specifies the tool, concrete actions, supported file types, comparative guidance (vs Jina), and explicit trigger terms. The description is concise yet comprehensive, making it easy for Claude to select this skill appropriately from a large pool.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists concrete actions ('Convert local documents to Markdown') and specifies the tool ('Microsoft's markitdown CLI'), supported formats (PDF, Word, Excel, PowerPoint, images, audio), and even notes a comparative capability ('Can fetch URLs but Jina is faster for web'). | 3 / 3 |
Completeness | Clearly answers 'what' (convert local documents to Markdown using markitdown CLI, supporting multiple formats) and 'when' (explicit 'Triggers on:' clause with specific trigger terms, plus 'Best for:' guidance on file types). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms: 'convert to markdown', 'read PDF', 'parse document', 'extract text from', 'docx', 'xlsx', 'pptx', 'OCR image', 'local file'. These are terms users would naturally use when needing this skill. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive by specifying the exact tool (markitdown CLI), focusing on local document conversion to Markdown, and even differentiating from a competing skill (Jina for web URLs). This makes it very unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill provides clear, actionable CLI commands for document conversion and makes good use of tables for decision-making. However, it suffers from significant redundancy—the Jina comparison appears in at least four places, and the Examples section largely duplicates Basic Usage. Consolidating redundant sections would make this a much stronger skill.
Suggestions
Remove the 'Examples' section entirely since it duplicates 'Basic Usage', or merge them into a single section with the most illustrative examples
Consolidate the Jina/Firecrawl comparison into a single location (the 'When to Use' table) and remove the 'Benchmarked Performance' and 'Comparison with Alternatives' sections which repeat the same information
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content has significant redundancy: the 'When to Use' table, 'Benchmarked Performance' table, and 'Comparison with Alternatives' table all repeat the same Jina-is-faster-for-URLs message multiple times. The 'Examples' section largely duplicates 'Basic Usage'. The supported formats table is useful but could be tighter. | 2 / 3 |
Actionability | All examples are concrete, executable bash commands that are copy-paste ready. The CLI usage is straightforward and complete with real file extensions and output redirection syntax. | 3 / 3 |
Workflow Clarity | This is a simple single-command tool with no multi-step workflow needed. The decision table for when to use markitdown vs alternatives is clear and unambiguous, making the single action easy to follow. | 3 / 3 |
Progressive Disclosure | The content is well-structured with clear sections and tables, but it's somewhat monolithic with redundant sections that could be consolidated. There are no references to external files, which is acceptable for this scope, but the inline content could be better organized to avoid repetition. | 2 / 3 |
Total | 10 / 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.
- Repository
- NeverSight/skills_feed
- Commit
f772de4
- 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.