CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

document-converter

Use for reading, analyzing, summarizing, and converting complex documents into Markdown artifacts or other supported document formats.

Quality

75%

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 ./backend/super-magic/agents/skills/document-converter/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

77%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.

The body is exceptionally actionable and workflow-safe: executable examples, explicit result.ok validation, error-recovery guidance, and per-file batch reporting. Its weaknesses are token efficiency (verbatim repeated helper code and rules stated multiple times) and the absence of any progressive disclosure — the entire tool API reference is inlined in one very long file.

Suggestions

Move the per-tool parameter reference (the eight Tools subsections) into a references/tools.md file and keep SKILL.md as a workflow overview with one-level-deep pointers.

Define the document_output_dir helper once and reference it in the examples instead of repeating it verbatim in three code blocks.

Consolidate the output-directory naming rule — currently stated in Code Mode Use, Batch Conversion Rules, and the export_document_markdown section — into a single stated contract.

DimensionReasoningScore

Conciseness

The body is dense with purposeful operational rules and never explains concepts Claude already knows, but the document_output_dir helper is repeated verbatim in three code examples, the output-directory naming rule is stated three times, and the run_sdk_snippet vs run_python_snippet distinction is explained three times — more than the minor over-explanation of anchor 4, matching the could-be-tightened anchor.

3 / 5

Actionability

Eight copy-paste-ready run_sdk_snippet examples with exact tool names, full parameter dictionaries, absolute paths, and result.ok checks cover the common cases (inspect/sample/plan, range extraction, image understanding, export, batch export, summarize, format conversion, convert-then-export), with concrete thresholds like "at most 10 images per call" and "10 or fewer pages/slides/images".

5 / 5

Workflow Clarity

Clear ordered sequences (Default Approach 1-10, summary sequence 1-7, inspect → sample → plan → extract → understand → summarize) are backed by explicit validation in every example ("Always check result.ok before using the result"), error-recovery loops ("use the tool error to decide whether to switch to export_document_markdown... or tell the user"), and batch validation ("Count success from actual tool results and output files, not from the planned file list"), so the batch-operation cap does not apply.

5 / 5

Progressive Disclosure

No bundle files exist and the full 8-tool API reference with parameters plus all eight code examples are inlined in a single 518-line SKILL.md; section headers are clear and well organized (above the no-structure anchors), but content that belongs in separate reference files is fully inline with no references at all, matching the should-be-separate-is-inline anchor.

3 / 5

Total

16

/

20

Passed

Description

63%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.

The description has a clear capability list with an explicit "Use for" trigger clause and a distinctive Markdown-artifact output focus. Its main weaknesses are the total absence of file-format keywords (PDF, Word, .docx) and generic object terms ("complex documents"), which weaken trigger matching and distinctiveness against other document skills.

Suggestions

Name input formats explicitly (e.g., "PDF, Word, PowerPoint, Excel, and scanned documents") so users saying "PDF" or ".docx" naturally trigger the skill.

Add a distinct 'Use when...' clause with concrete trigger phrases (e.g., "Use when the user asks to read, summarize, analyze, or convert PDFs, slides, spreadsheets, or Office documents") rather than folding the trigger into the capability list.

Mention common synonyms such as "slides" and "spreadsheets" alongside "complex documents" to broaden natural trigger coverage without adding vagueness.

DimensionReasoningScore

Specificity

Lists four enumerated actions ("reading, analyzing, summarizing, and converting") plus a concrete output ("Markdown artifacts"), matching the several-specific-actions anchor; it falls short of anchor 5 because input formats (PDF, Office, etc.) are never named and "other supported document formats" is unspecified.

4 / 5

Completeness

Both are present: a clear what ("converting complex documents into Markdown artifacts or other supported document formats") and explicit trigger guidance ("Use for reading, analyzing, summarizing..."); the when-clause only restates the action list rather than giving concrete trigger phrases like "when the user mentions PDFs", so it is not anchor 5.

4 / 5

Trigger Term Quality

Natural action verbs ("summarizing", "converting", "Markdown") are present, but the most common user trigger terms — PDF, Word, slides, spreadsheets, .pdf, .docx — are entirely missing and "complex documents" is generic, matching the missing-common-variations anchor rather than the good-coverage anchor.

3 / 5

Distinctiveness Conflict Risk

"complex documents" is broad and would overlap with any PDF, Office, or presentation skill, and no format-specific triggers are given to reduce conflict; the Markdown-artifact output focus adds some distinctiveness, placing it at the could-still-overlap anchor rather than the minor-overlap anchor.

3 / 5

Total

14

/

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

skill_md_line_count

SKILL.md is long (518 lines); consider splitting into references/ and linking

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

14

/

16

Passed

Repository

dtyq/magic

Path

backend/super-magic/agents/skills/document-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.