CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

80

Quality

100%

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

100%

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

The body is a tight, actionable wrapper around markitdown with executable commands, clear sequencing, and well-organized sections that need no external references. It avoids concept-padding and supplies error-recovery guidance in troubleshooting.

DimensionReasoningScore

Conciseness

The body is lean: it skips concept explanations Claude already knows (no "what is a PDF"), and tokens like the install/PATH note and format list each earn their place, matching the "lean and efficient" anchor.

3 / 3

Actionability

It provides copy-paste-ready, executable bash commands (single-file convert, save to file, pipe to a tool), a numbered attached-file flow, and a concrete flags table rather than vague direction.

3 / 3

Workflow Clarity

The attached-file workflow is a clearly sequenced 2-step process (convert, then read); since conversion is non-destructive no validation checkpoint is required, and the troubleshooting section supplies error-recovery guidance for OCR/chart edge cases.

3 / 3

Progressive Disclosure

This single-purpose tool wrapper needs no external bundle files (none exist) and is organized into well-signaled sections (Supported formats, Basic usage, Reading a user-attached file, Useful flags, When NOT to use, Troubleshooting), so the overview stands cleanly on its own.

3 / 3

Total

12

/

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, concise description that clearly states the capability, lists concrete input formats, and provides an explicit use-trigger in third person. It hits the top anchor on every dimension with no over-claims or fluff.

DimensionReasoningScore

Specificity

The description names the concrete action ("Convert binary documents ... to clean LLM-friendly Markdown") and enumerates seven specific input formats, matching the "lists multiple specific concrete actions" anchor.

3 / 3

Completeness

It explicitly answers both "what" (convert binary docs to Markdown via markitdown) and "when" ("Use when a user attaches a binary file and you need to read its contents"), with an explicit trigger clause.

3 / 3

Trigger Term Quality

It surfaces natural terms users would actually say (PDF, DOCX, XLSX, PPTX, HTML, EPUB, images, binary file), giving good coverage of common variations rather than technical jargon.

3 / 3

Distinctiveness Conflict Risk

The binary-to-Markdown conversion niche is distinct and uses third-person voice ("Convert binary documents"), making it unlikely to trigger 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
Team-Commonly/commonly
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.