CtrlK
BlogDocsLog inGet started
Tessl Logo

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

1.35x
Quality

100%

Does it follow best practices?

Impact

95%

1.35x

Average score across 3 eval scenarios

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
intellectronica/agent-skills
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.