Convert documents and files to Markdown using markitdown. Use when converting PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls), HTML, CSV, JSON, XML, images (with EXIF/OCR), audio (with transcription), ZIP archives, YouTube URLs, or EPubs to Markdown format for LLM processing or text analysis.
99
100%
Does it follow best practices?
Impact
95%
1.35xAverage 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 hits all the marks. It names a specific tool, lists comprehensive supported formats with both common names and file extensions, includes an explicit 'Use when' clause, and clearly defines its niche as format-to-Markdown conversion. The description is thorough yet well-organized and avoids vague language.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names a specific tool ('markitdown') and lists multiple concrete file types and conversion scenarios. It clearly states the action: 'Convert documents and files to Markdown.' | 3 / 3 |
Completeness | Clearly answers both 'what' (convert documents to Markdown using markitdown) and 'when' (explicit 'Use when' clause listing all supported formats and purposes like 'LLM processing or text analysis'). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms including file extensions (.docx, .pptx, .xlsx, .xls), full names (PDF, Word, PowerPoint, Excel, HTML, CSV, JSON, XML), and use cases (OCR, transcription, LLM processing, text analysis). Users searching for any of these formats would match. | 3 / 3 |
Distinctiveness Conflict Risk | The specific tool name 'markitdown', the clear focus on conversion to Markdown format, and the comprehensive list of supported input formats create a distinct niche that is unlikely to conflict with other skills like PDF extraction or spreadsheet analysis tools. | 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 is concise, actionable, and well-structured. It provides everything Claude needs to use markitdown effectively without any unnecessary explanation or verbosity. The progression from basic usage to options to examples is logical and the content is immediately executable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient. It assumes Claude knows what these file formats are and jumps straight to executable commands. Every section earns its place with no unnecessary explanation of concepts. | 3 / 3 |
Actionability | All examples are fully executable bash commands that are copy-paste ready. The options section provides concrete flags with clear descriptions, and multiple real-world usage examples are provided. | 3 / 3 |
Workflow Clarity | This is a simple, single-purpose skill (convert file to markdown). The single action is unambiguous, and the workflow is clear: run the command, get output. No destructive or batch operations require validation checkpoints. | 3 / 3 |
Progressive Disclosure | For a skill under 50 lines with no need for external references, the content is well-organized into logical sections (Basic Usage → Supported Formats → Options → Examples → Notes) that are easy to scan and navigate. | 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.
9b0e00a
Table of Contents
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.