CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

whisper

OpenAI's general-purpose speech recognition model. Supports 99 languages, transcription, translation to English, and language identification. Six model sizes from tiny (39M params) to large (1550M params). Use for speech-to-text, podcast transcription, or multilingual audio processing. Best for robust, multilingual ASR.

Quality

77%

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/multimodal/whisper/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

A highly actionable, code-heavy reference for Whisper with accurate API usage across Python and CLI. Its main weaknesses are an unreferenced bundle file whose content is partially duplicated inline, a batch-processing example lacking validation, and a few padded sections (GitHub-star metrics, performance tables).

Suggestions

Replace the inline 'Language support' section with a one-line pointer to references/languages.md (e.g., 'See [languages.md](references/languages.md) for the full 99-language list, WER by model size, and language-specific tips') so the bundle file is actually discoverable and the duplication is removed.

Add validation to the batch processing example: wrap the transcribe call in try/except, check that each input file exists before processing, and confirm the output file was written before moving on.

Trim the 'Metrics' block (GitHub star counts are time-sensitive and not actionable) and drop or shrink the CPU/GPU real-time-factor performance table, which largely repeats the speed column already shown in the model sizes table.

DimensionReasoningScore

Conciseness

The body is mostly efficient, code-first content, but the inline 'Language support' section ('Top-supported languages... Full list: 99 languages total') duplicates references/languages.md, and the 'Metrics' block ('72,900+ GitHub stars') and the CPU/GPU real-time-factor performance table add little actionable value. This is more than anchor 4's 'minor instances' of padding but far from anchor 2's heavily padded style.

3 / 5

Actionability

Nearly all guidance is copy-paste ready: 'pip install -U openai-whisper', 'whisper audio.mp3 --output_format srt', and model.transcribe() examples with language, task, initial_prompt, word_timestamps, and temperature options. It falls short of anchor 5 because the LangChain section ('from langchain.document_loaders import WhisperTranscriptionLoader') references a loader that does not appear to exist and uses a deprecated import path, so that example is not reliably executable.

4 / 5

Workflow Clarity

The core single action (load model, transcribe) is unambiguous, but the batch processing section loops over files writing outputs with no validation or error handling, and the rubric explicitly caps workflow clarity at 3 for batch operations without verification steps. It is not anchor 2 because the sequences that are present are coherent and well-ordered.

3 / 5

Progressive Disclosure

The body is well-sectioned with headers, but the one bundle file (references/languages.md) is never referenced or linked anywhere in SKILL.md — the 'Language support' section says 'Full list: 99 languages total' with no pointer to the file — and its content is partially inlined instead. This matches anchor 3 ('references present but not clearly signaled; content that should be separate is inline') rather than anchor 4's 'references mostly clear'.

3 / 5

Total

13

/

20

Passed

Description

87%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: third-person voice, concrete capabilities, and an explicit 'Use for...' clause with natural trigger phrases. Both 'what' and 'when' are clearly answered with minimal conflict risk against other skills.

DimensionReasoningScore

Specificity

The description lists several concrete capabilities — 'transcription, translation to English, and language identification' plus 'Six model sizes from tiny (39M params) to large (1550M params)' — with only minor gaps (no mention of timestamps, subtitles, or CLI usage). It falls short of anchor 5's comprehensive coverage but clearly exceeds the 1-2 actions of anchor 3.

4 / 5

Completeness

It explicitly answers both what ('Supports 99 languages, transcription, translation to English, and language identification') and when ('Use for speech-to-text, podcast transcription, or multilingual audio processing') with concrete trigger phrases. The 'when' clause is explicit and specific, matching the anchor 5 example's structure rather than anchor 4's 'could be more explicit'.

5 / 5

Trigger Term Quality

Natural trigger phrases are present: 'speech-to-text, podcast transcription, or multilingual audio processing' plus 'ASR' and 'speech recognition'. A few common natural terms are missing (e.g., 'captions', 'subtitles', 'transcribe audio/video'), so it does not reach anchor 5's synonym-and-extension-level coverage.

4 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche — OpenAI's speech recognition model for multilingual ASR — with distinct triggers ('speech-to-text', 'podcast transcription', 'multilingual audio processing') that are unlikely to fire for unrelated skills, matching anchor 5.

5 / 5

Total

18

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

OpenLAIR/dr-claw

Path

skills/multimodal/whisper/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.