CtrlK
BlogDocsLog inGet started
Tessl Logo

openai-whisper

Local speech-to-text with the Whisper CLI (no API key).

64

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/openai-whisper/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 body is an efficient, well-organized quick-reference: two copy-paste-ready commands covering transcription and translation, plus concise practical notes on model caching and selection. As a simple single-purpose skill it meets the bar for top marks on conciseness, actionability, workflow clarity, and progressive disclosure.

DimensionReasoningScore

Conciseness

The body is a lean set of two executable commands plus four short notes with no explanation of what Whisper is or how speech-to-text works, so every token earns its place, matching the 'lean and efficient' anchor; it does not pad with concepts Claude already knows.

3 / 3

Actionability

Both Quick start entries are concrete, fully formed copy-paste commands with real flags (--model, --output_format, --task), matching the 'fully executable, copy-paste ready' anchor rather than the pseudocode score-2 example.

3 / 3

Workflow Clarity

This is a simple single-action skill (run one transcription/translation command) whose action is unambiguous, so per the simple-skills scoring note workflow clarity can score 3 even without a multi-step sequence or validation checkpoint; transcription is non-destructive so none is required.

3 / 3

Progressive Disclosure

At under 50 lines with no external references needed, the body is well-organized into Quick start and Notes sections, satisfying the simple-skill clause that well-organized sections alone warrant a 3; no monolithic wall of text or nested references are present.

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 distinctive, naming Whisper and local no-API-key transcription, but it lacks an explicit trigger clause and misses common user terms like "transcription" and "audio". Specificity is adequate rather than comprehensive, listing one action.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when transcribing audio files locally or when the user asks for speech-to-text without an API key.'

Broaden trigger terms to include natural variations such as "transcription", "transcribe", "audio", and "voice".

Enumerate concrete capabilities (transcribe, translate, output text/SRT) to lift specificity from one action to several.

DimensionReasoningScore

Specificity

"Local speech-to-text" names the domain and "(no API key)" adds a concrete detail, but only a single action is named rather than multiple specific concrete actions, matching the 'names domain and some actions' anchor and falling short of the multi-action score-3 example.

2 / 3

Completeness

The description states what the skill does (local speech-to-text via Whisper CLI) but never states when to use it; per the judging guidelines, a missing explicit 'Use when...' trigger caps completeness at 2.

2 / 3

Trigger Term Quality

"speech-to-text" and "Whisper CLI" are relevant keywords a user might say, but common variations such as "transcription", "transcribe", "audio", and "voice" are absent, fitting the 'some relevant keywords but missing common variations' anchor rather than the broad score-3 coverage.

2 / 3

Distinctiveness Conflict Risk

"Whisper CLI" combined with "Local" and "(no API key)" carves a clear, narrow niche unlikely to overlap with other skills, matching the 'clear niche with distinct triggers' anchor rather than the overlap-prone score-2 example.

3 / 3

Total

9

/

12

Passed

Validation

81%

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

Validation13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

16

Passed

Repository
Bitterbot-AI/bitterbot-desktop
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.