CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

markdown-converter

Convert binary documents (PDF, DOCX, XLSX, PPTX, HTML, EPUB, images) to clean LLM-friendly Markdown using Microsoft's `markitdown` Python tool. Use when a user attaches a binary file and you need to read its contents.

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

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

An efficient, actionable single-file skill: executable commands, a clear exclusion section pointing to sibling skills, and real troubleshooting guidance. The only notable flaw is the awkward environment-specific path templating in the command examples, which slightly hurts copy-paste readiness.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: no explanation of what PDFs or libraries are, and every section ("Supported input formats", "Useful flags", "When NOT to use", "Troubleshooting") carries operational value. The one-sentence intro earns its place by stating install status and PATH availability, matching anchor 5 rather than anchor 4's "minor instances of over-explanation".

5 / 5

Actionability

Commands are concrete and mostly executable ("markitdown ... > /workspace/.../input.md", "markitdown ... | head -200", the flags table, and the 2-step numbered workflow for attached files). The recurring "/workspace/$(basename "$PWD")/" path templating is valid shell but not cleanly copy-paste-ready, and `-o <file>` is listed without a usage example, keeping it below anchor 5.

4 / 5

Workflow Clarity

This is a simple single-task skill and the primary workflow ("1. Convert the binary to markdown ... 2. Read the markdown into your context") is unambiguous and correctly sequenced. The operation is read-only and non-destructive, so the validation-cap rule does not apply, and the Troubleshooting section addresses the main failure mode (OCR-heavy PDFs returning garbage).

5 / 5

Progressive Disclosure

The skill is a single well-organized SKILL.md (~60 lines) with no bundle files and no content that belongs in separate references; sections are clearly headed and easy to navigate. Per the rubric's simple-skill guidance, well-organized sections with no need for external references merit the top score.

5 / 5

Total

19

/

20

Passed

Description

83%Weight 40%Scale 1-5

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 description: concrete action, named tool, full format enumeration, and an explicit use-when trigger clause. Its only weakness is reliance on file extensions rather than natural synonyms (Word, Excel, PowerPoint) in the trigger terms.

DimensionReasoningScore

Specificity

"Convert binary documents (PDF, DOCX, XLSX, PPTX, HTML, EPUB, images) to clean LLM-friendly Markdown" names the concrete action, the tool, and enumerates input formats comprehensively for a single-purpose converter. It lists one action rather than several distinct actions, so it does not reach the anchor-5 example's level, but format enumeration makes coverage complete enough to sit above anchor 3.

4 / 5

Completeness

It explicitly answers both parts: the "what" ("Convert binary documents ... to clean LLM-friendly Markdown using Microsoft's `markitdown`") and a concrete "when" ("Use when a user attaches a binary file and you need to read its contents"). The when-clause is explicit and specific, matching the anchor-5 example pattern rather than anchor 4's "could be more explicit".

5 / 5

Trigger Term Quality

File extensions are well covered ("PDF, DOCX, XLSX, PPTX, HTML, EPUB") alongside natural phrases like "attaches a binary file" and "read its contents". Common synonyms such as "Word", "Excel", "PowerPoint", or "spreadsheet" are missing, which keeps it below anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche — binary-to-Markdown conversion for LLM input via a named tool — but the trigger clause "Use when a user attaches a binary file and you need to read its contents" is broad enough to overlap with generic file-reading or PDF-extraction skills. That places it at anchor 4 ("mostly distinct; minor overlap risk with closely related skills") rather than anchor 5's minimal conflict risk.

4 / 5

Total

17

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

Team-Commonly/commonly

Path

backend/commonly-bundled-skills/markdown-converter/SKILL.md

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.