markdown-converter
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 key criteria. It uses third person voice, provides specific capabilities with comprehensive file format coverage, includes explicit trigger guidance with a 'Use when...' clause, and clearly distinguishes itself through the markitdown tool and Markdown conversion focus.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists a specific concrete action ('Convert documents and files to Markdown using markitdown') and comprehensively enumerates supported file types including PDF, Word, PowerPoint, Excel, HTML, CSV, JSON, XML, images, audio, ZIP archives, YouTube URLs, and EPubs. | 3 / 3 |
Completeness | Clearly answers both 'what' (convert documents to Markdown using markitdown) and 'when' with an explicit 'Use when...' clause that specifies conversion scenarios and lists all supported input formats plus the purpose (LLM processing or text analysis). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: includes file extensions (.docx, .pptx, .xlsx, .xls), common format 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 naturally match. | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche focused specifically on Markdown conversion via markitdown tool. The explicit mention of the tool name and the specific conversion direction (to Markdown) distinguishes it from general document processing or PDF-specific skills. | 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 exemplary skill file that demonstrates excellent token efficiency while providing complete, actionable guidance. It assumes Claude's competence, provides executable examples, and organizes content logically. The skill accomplishes its purpose without any unnecessary verbosity or missing information.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely lean and efficient. No unnecessary explanations of what Markdown is or how conversion works. Every section provides direct, actionable information without padding. | 3 / 3 |
Actionability | Fully executable bash commands throughout. Examples are copy-paste ready with real file extensions and clear output options. The options section provides complete flag reference. | 3 / 3 |
Workflow Clarity | This is a simple, single-purpose skill (file conversion). The workflow is unambiguous: run command, get output. No multi-step process requiring validation checkpoints. The Azure fallback for complex PDFs provides appropriate guidance for edge cases. | 3 / 3 |
Progressive Disclosure | Well-organized sections progress logically from basic usage to supported formats to options to examples. For a skill under 50 lines with no need for external references, the structure is appropriate and easy to 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.
- Repository
- intellectronica/agent-skills
- Commit
9f7f750
- 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.