CtrlK
BlogDocsLog inGet started
Tessl Logo

markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

66

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/markdown-converter/SKILL.md
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 content is a tight, fully-actionable reference for a single-purpose tool: every section is executable, well-organized, and free of padding. No changes needed for a skill of this scope.

DimensionReasoningScore

Conciseness

The body is lean and efficient with no concept-explaining fluff; sections like Basic Usage, Options, and Notes each earn their tokens by providing only actionable, non-obvious information.

3 / 3

Actionability

Provides fully executable `uvx markitdown` commands with concrete flags and copy-paste-ready examples covering stdout, file output, stdin hints, and Azure Document Intelligence.

3 / 3

Workflow Clarity

This is a simple single-task skill whose single action (run markitdown with options) is unambiguous, so workflow clarity scores 3 under the simple-skill allowance without needing multi-step validation.

3 / 3

Progressive Disclosure

Under 50 lines with no need for external references, the content is organized into clear, well-labeled sections (Basic Usage, Supported Formats, Options, Examples, Notes), satisfying the simple-skill progressive-disclosure bar.

3 / 3

Total

12

/

12

Passed

Description

57%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is concise and names a broad range of target formats, giving it a clear niche, but it relies on a single action verb and omits any explicit "Use when..." trigger guidance. Adding trigger phrasing and more concrete action verbs would lift the weaker dimensions.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when converting files like PDF, Word, or HTML to Markdown'.

Replace generic terms ('data', 'OCR', 'audio') with concrete format names users say (e.g. 'Word/Excel/PowerPoint', 'images', 'audio transcription').

Expand beyond the single action 'Markdown conversion' to mention concrete outcomes like 'extract text and tables', 'transcribe audio', or 'unpack ZIP archives'.

DimensionReasoningScore

Specificity

Names many target domains ("PDF, Office, HTML, data, OCR, audio, ZIP, YouTube") but offers only one action ("Markdown conversion"), so it does not reach the multiple-concrete-actions bar of 3.

2 / 3

Completeness

Clearly states what the skill does ("Markdown conversion") but provides no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 2 per the rubric guidelines.

2 / 3

Trigger Term Quality

Includes natural terms like "PDF", "Office", "HTML", "YouTube", and "ZIP", but misses common variations users would say such as "Word", "Excel", "PowerPoint", or "convert to markdown".

2 / 3

Distinctiveness Conflict Risk

"Markdown conversion" across a listed set of formats is a clear, well-defined niche unlikely to trigger for unrelated skills, matching the clear-niche anchor.

3 / 3

Total

9

/

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
steipete/agent-scripts
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.