openai-whisper
Local speech-to-text with the Whisper CLI (no API key).
76
70%
Does it follow best practices?
Impact
91%
0.91xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/openai-whisper/SKILL.mdQuality
Discovery
40%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 identifies a clear niche (local Whisper CLI transcription without an API key), which makes it distinctive. However, it lacks specific actions (e.g., transcribe audio, generate subtitles, convert formats), misses common trigger terms users would naturally use, and has no explicit 'Use when...' guidance for Claude to know when to select this skill.
Suggestions
Add a 'Use when...' clause, e.g., 'Use when the user wants to transcribe audio or video files locally, or mentions Whisper, speech-to-text, or transcription.'
List specific actions such as 'Transcribes audio/video files to text, generates subtitles/SRT files, supports multiple languages and formats (.mp3, .wav, .m4a).'
Include natural trigger terms users would say: 'transcribe', 'audio', 'transcription', 'voice to text', 'subtitles', 'SRT', '.mp3', '.wav'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (speech-to-text) and the tool (Whisper CLI), and notes 'no API key', but doesn't list specific actions like transcribing audio files, generating subtitles, or specifying supported formats. | 2 / 3 |
Completeness | Describes what at a high level (speech-to-text with Whisper CLI) but has no 'Use when...' clause or explicit trigger guidance, which per the rubric caps completeness at 2, and the 'what' is also quite thin, bringing it to 1. | 1 / 3 |
Trigger Term Quality | Includes useful terms like 'speech-to-text', 'Whisper', and 'CLI', but misses common user-facing terms like 'transcribe', 'audio', 'transcription', '.mp3', '.wav', 'subtitles', or 'voice to text'. | 2 / 3 |
Distinctiveness Conflict Risk | The combination of 'speech-to-text', 'Whisper CLI', and 'no API key' creates a very clear niche that is unlikely to conflict with other skills. | 3 / 3 |
Total | 8 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an excellent, lean skill that respects Claude's intelligence and provides immediately actionable CLI commands. It covers the essential use cases (transcribe, translate) with concrete examples and includes only non-obvious notes about model caching and defaults. No improvements needed for its scope.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every token earns its place. No unnecessary explanations of what Whisper is or how speech-to-text works. The notes section contains only non-obvious, install-specific details. | 3 / 3 |
Actionability | Provides fully executable, copy-paste-ready commands with real flags and file paths. Covers both transcription and translation use cases with concrete examples. | 3 / 3 |
Workflow Clarity | This is a simple, single-purpose skill (run a CLI command). The single action is unambiguous, and the notes clarify model defaults and caching behavior. No multi-step or destructive operations require validation checkpoints. | 3 / 3 |
Progressive Disclosure | For a simple skill under 50 lines with no need for external references, the content is well-organized into a quick start section and notes. No bundle files are needed for this scope. | 3 / 3 |
Total | 12 / 12 Passed |
Validation
72%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 8 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
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 | 8 / 11 Passed | |
- Repository
- deepgram/dglabs-deepclaw
- Commit
ec8d4f8
- 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.