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.
Install with Tessl CLI
npx tessl i github:intellectronica/agent-skills --skill markdown-converter98
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 uses third person voice, provides comprehensive file format coverage with both common names and extensions, includes an explicit 'Use when...' clause, and clearly defines its unique purpose (Markdown conversion for LLM processing). The description is thorough yet not padded with unnecessary fluff.
| 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 the trigger conditions (converting any of the listed file types to Markdown for 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 purpose (converting TO Markdown) distinguishes it from skills that might read or process these file types for other purposes. | 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 perfectly matches its scope as a straightforward conversion utility.
| 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 validation needed for this non-destructive operation. | 3 / 3 |
Progressive Disclosure | Well-organized sections progress logically from basic usage to supported formats to options to examples. Under 50 lines with no need for external references; content is appropriately self-contained. | 3 / 3 |
Total | 12 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 13 / 16 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata' field is not a dictionary | Warning |
license_field | 'license' field is missing | Warning |
body_steps | No step-by-step structure detected (no ordered list); consider adding a simple workflow | Warning |
Total | 13 / 16 Passed | |
- 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.