CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

file-conversion

Use when the user needs a local file converted between common image, audio, video, document, or data formats. Select installed tools, preserve originals, and verify the output.

Quality

92%

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

SKILL.md
Quality
Evals
Security

Quality

Content

96%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 excellent, dense, fully executable skill body: hardened shell examples, a clear inspect-to-verify workflow with explicit validation and failure handling, and no filler. The only structural improvement would be moving the per-format example routes into separate reference files to keep SKILL.md a leaner overview.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — it never explains what formats or codecs are, and every aside earns its place ('MP3 encoding is lossy', 'A zero exit status alone is insufficient'). It fits anchor 5: every token earns its place, and nothing reads as padding.

5 / 5

Actionability

All five example routes are fully executable, copy-paste-ready commands with correct hardening flags (-nostdin -n -protocol_whitelist file,pipe, mktemp-based output dirs, trap cleanup for the soffice profile, strict='True' CSV parsing, exclusive 'x' output mode) covering the most common conversion cases. This matches anchor 5.

5 / 5

Workflow Clarity

The sequence — inspect/choose (4 numbered steps with a tool-selection table), preserve originals (mktemp dir, never overwrite), convert, then verify — has explicit validation checkpoints ('Reopen it with a reader for the target format; a new suffix does not prove conversion') and error-recovery guidance ('On failure, retain the original... do not present a partial file as a completed conversion'). This matches the validate/fix/retry feedback-loop anchor 5.

5 / 5

Progressive Disclosure

Sections are well organized and the external doc links (FFmpeg, Pandoc, LibreOffice) are clearly signaled one level deep, but at ~150 lines the five per-format example routes could be split into references/ files. Anchor 4 (good structure, minor organization gaps) fits better than 5, whose under-50-lines exception does not apply here.

4 / 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 with an explicit 'Use when...' trigger, a clear what, natural trigger terms, and a distinct local-conversion niche. Its only gaps are a slightly thin enumeration of capabilities and the absence of file-extension synonyms.

DimensionReasoningScore

Specificity

The description names the domain ('local file converted between common image, audio, video, document, or data formats') and lists three concrete actions ('Select installed tools, preserve originals, and verify the output'). This matches anchor 4 — several specific actions with minor gaps in coverage — rather than 5, since it does not comprehensively itemize what the conversion workflows entail.

4 / 5

Completeness

It explicitly answers both questions: 'Use when the user needs a local file converted between common... formats' states the trigger, and 'Select installed tools, preserve originals, and verify the output' states what it does. This matches the anchor-5 example structure of a concrete what plus an explicit when with trigger phrases.

5 / 5

Trigger Term Quality

Natural phrases like 'local file', 'converted', and the five format-family keywords give good coverage a user would plausibly say. A few natural terms are missing (e.g., 'transcode', 'export as', or file extensions like .mp4/.pdf/.png), which keeps it at anchor 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

The niche — local format conversion with originals preserved — is distinct, and 'local' plus the format families act as distinct triggers. Minor overlap risk remains with format-specific skills (e.g., a PDF or media skill), matching anchor 4 rather than 5.

4 / 5

Total

17

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

wshobson/agents

Path

plugins/file-conversion/skills/file-conversion/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.