openai-whisper-api

Transcribe audio via OpenAI Audio Transcriptions API (Whisper).

2.27x

Quality

70%

Does it follow best practices?

Impact

91%

2.27x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/openai-whisper-api/SKILL.md

Quality

Content

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, concise skill that provides immediately actionable guidance for audio transcription via the OpenAI Whisper API. It assumes Claude's competence, avoids unnecessary explanation, and covers the key variations through concrete flag examples. The structure is clean and appropriately sized for the task's simplicity.

Dimension	Reasoning	Score
Conciseness	Every token earns its place. No unnecessary explanations of what Whisper is or how APIs work. The content is lean, showing only the command, defaults, flags, and API key configuration.	3 / 3
Actionability	Provides fully executable bash commands with concrete flag examples covering common use cases (language, prompt, JSON output, custom output path). The quick start is copy-paste ready.	3 / 3
Workflow Clarity	This is a simple single-task skill (run a script to transcribe audio). The single action is unambiguous with clear defaults stated, and the flag examples cover the main variations. No multi-step process or destructive operations require validation checkpoints.	3 / 3
Progressive Disclosure	For a simple skill under 50 lines, the content is well-organized into logical sections (quick start, flags, API key config). No bundle files were provided, but the skill references a script at a clear path, and the content doesn't need external references to be complete.	3 / 3
	Total	12 / 12 Passed

Description

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 is concise and identifies a clear, specific tool and action, giving it good distinctiveness. However, it lacks a 'Use when...' clause and misses common user-facing trigger terms like 'speech-to-text' or audio file extensions, significantly reducing its effectiveness for skill selection in a large pool.

Suggestions

Add a 'Use when...' clause with explicit triggers, e.g., 'Use when the user wants to transcribe audio files, convert speech to text, or process voice recordings.'

Include common natural trigger terms and file extensions such as 'speech-to-text', 'voice recording', '.mp3', '.wav', '.m4a' to improve discoverability.

List additional specific capabilities if applicable, such as 'supports multiple languages, generates timestamps, handles various audio formats'.

Dimension	Reasoning	Score
Specificity	Names the domain (audio transcription) and the specific tool (OpenAI Audio Transcriptions API / Whisper), but only describes a single action ('transcribe audio') without listing additional concrete capabilities like supported formats, timestamps, language detection, etc.	2 / 3
Completeness	It answers 'what does this do' (transcribe audio via Whisper) but completely lacks a 'Use when...' clause or any explicit trigger guidance, which per the rubric should cap completeness at 2, and since the 'when' is entirely missing, it scores 1.	1 / 3
Trigger Term Quality	Includes relevant keywords like 'transcribe', 'audio', 'OpenAI', and 'Whisper', which users might naturally say. However, it misses common variations like 'speech-to-text', 'convert audio to text', 'voice recording', or file extensions like '.mp3', '.wav'.	2 / 3
Distinctiveness Conflict Risk	The description is quite distinctive by specifying both the exact API (OpenAI Audio Transcriptions API) and the model (Whisper), making it clearly distinguishable from other skills and unlikely to conflict with unrelated skills.	3 / 3
	Total	8 / 12 Passed

Validation

72%

Warnings & errors only

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: about 1 month ago

Table of Contents

Discovery Implementation Validation

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.