CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

91

2.37x
Quality

Does it follow best practices?

Impact

83%

2.37x

Average score across 3 eval scenarios

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-organized, highly actionable single-file skill with copy-paste commands and clear sections. Its main weakness is redundancy: the Examples section repeats Basic Usage and three comparison tables overlap on the same Jina/markitdown tradeoff.

Suggestions

Merge the "Examples" section into "Basic Usage" (or drop it) since the same commands (report.pdf, screenshot.png, presentation.pptx, meeting.mp3) already appear there.

Consolidate the "When to Use", "Benchmarked Performance", and "Comparison with Alternatives" tables into one table to remove the repeated Jina-vs-markitdown tradeoff.

DimensionReasoningScore

Conciseness

Tone is lean with no concept-explanation fluff, but the "Examples" section largely duplicates "Basic Usage" and three tables (When to Use, Benchmarked Performance, Comparison with Alternatives) overlap heavily on the Jina-vs-markitdown story, so it could be tightened.

2 / 3

Actionability

Fully executable, copy-paste-ready commands such as "markitdown document.pdf" and "markitdown document.pdf > document.md" are provided for every supported format.

3 / 3

Workflow Clarity

A single-purpose skill with an unambiguous, sequenced action (run markitdown, redirect to save); per the simple-skills note this scores 3, and no destructive or batch operation requires validation checkpoints.

3 / 3

Progressive Disclosure

A single self-contained file organized into clear, navigable sections with no nested or deep references; no bundle files are present to verify, which is appropriate for a skill this size.

3 / 3

Total

11

/

12

Passed

Description

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.

A strong, third-person description that states concrete capabilities, lists natural trigger terms, and clearly marks when to use it while carving out its niche against competing tools. No first/second-person voice or vague fluff.

DimensionReasoningScore

Specificity

Names the tool and concrete action ("Convert local documents to Markdown using Microsoft's markitdown CLI") plus multiple specific formats including OCR and audio, matching the anchor for listing multiple specific concrete actions.

3 / 3

Completeness

Explicitly answers both what (convert local documents to Markdown via markitdown) and when (an explicit "Triggers on:" clause equivalent to "Use when"), so it is not capped at 2.

3 / 3

Trigger Term Quality

"Triggers on: convert to markdown, read PDF, parse document, extract text from, docx, xlsx, pptx, OCR image, local file" gives good coverage of natural user phrases and file extensions.

3 / 3

Distinctiveness Conflict Risk

Clear niche (local files) and explicitly distinguishes itself from Jina and Firecrawl ("Jina is faster for web"), with triggers unlikely to fire for the wrong skill.

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
NeverSight/skills_feed
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.