CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

audio-transcriber

Transform audio recordings into professional Markdown documentation with intelligent summaries using LLM integration

Quality

51%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/audio-transcriber/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body contains genuinely useful fragments (tool detection, metadata extraction, output template) buried in heavy padding and an incoherent workflow: the numbering skips steps, the actual transcription invocation is missing, and two of three bundle files are never referenced. Pseudocode placeholders substitute for the real logic that already exists in scripts/transcribe.py.

Suggestions

Fix the step numbering (0, 1, 3, 5 with a referenced-but-missing Step 0b) and add the missing core transcription step, delegating to the existing scripts/transcribe.py rather than pseudocode placeholders like call_ai_model.

Drastically trim the decorative content: the 60-line interactive install dialogue, box-drawing prompt mockups, ASCII progress bars, and duplicated bilingual echo blocks add hundreds of tokens with little instructional value.

Link the orphaned bundle files (references/tools-comparison.md, scripts/transcribe.py) from the body, and move the full example transcripts (batch processing, large-file, final-output samples) into a separate examples reference file.

Resolve the mixed Portuguese/English content ('Ata salva', 'transcreva estes áudios', 'Usar versão melhorada?') and the mojibake-encoded emoji into a single consistent language.

DimensionReasoningScore

Conciseness

The ~550-line body is heavily padded with a 60-line interactive install dialogue, box-drawing prompt mockups, ASCII progress bars, duplicated bilingual echo blocks, and full bash scripts Claude could write unaided. Padding is pervasive rather than confined to a few sections, matching anchor 1 more than anchor 2.

1 / 5

Actionability

Concrete guidance exists (tool detection, ffprobe metadata extraction, format conversion, timestamped output naming), but the core transcription step is never given as executable code, the Python is pseudocode with undefined functions (call_ai_model, cluster_by_topic, extract_action_items), and the existing scripts/transcribe.py is never referenced. This matches anchor 3: some concrete guidance but incomplete, with pseudocode instead of executable code.

3 / 5

Workflow Clarity

The step sequence is incoherent: steps jump 0 to a referenced-but-absent 'Step 0b', then 1, 3, and 5, with the actual transcription step missing entirely; examples are numbered 1, 3, 5. Although file/format validation exists, the many gaps and poorly defined steps match anchor 2 ('rough sequence present but many gaps') better than anchor 3, where checkpoints rather than the steps themselves are what's missing.

2 / 5

Progressive Disclosure

Section headers exist (Purpose, When to Use, Workflow, Example Usage) and scripts/install-requirements.sh is referenced, but references/tools-comparison.md and scripts/transcribe.py are never linked from the body, and hundreds of lines of sample outputs and dialogue transcripts that belong in separate files are inlined. This matches anchor 3 (some structure, references not clearly signaled, separable content inline) rather than anchor 2's headerless monolith.

3 / 5

Total

9

/

20

Passed

Description

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

The description communicates a clear domain and basic capability but is generic in its trigger coverage. It lacks any 'Use when...' guidance and omits the natural keywords (transcribe, meeting minutes, speech-to-text, file formats) users would actually say.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user wants to transcribe audio, generate meeting minutes from recordings, or asks to convert audio/video files to text.'

Include natural trigger terms and synonyms users would say: 'transcribe', 'transcription', 'meeting minutes', 'speech-to-text', and file extensions like mp3, wav, m4a.

Replace the vague 'intelligent summaries using LLM integration' with concrete actions such as 'generates meeting minutes, action items, and executive summaries from transcripts'.

DimensionReasoningScore

Specificity

Names the domain ('Transform audio recordings into professional Markdown documentation') and 1-2 concrete actions (documentation generation, summaries), but 'intelligent summaries using LLM integration' is buzzword-adjacent and coverage is not comprehensive (no mention of transcription, meeting minutes, or subtitles).

3 / 5

Completeness

The 'what' is reasonably clear (audio-to-Markdown documentation with summaries), but there is no 'Use when...' clause or any trigger guidance, which caps completeness at 3 per the rubric guidelines.

3 / 5

Trigger Term Quality

Contains some relevant keywords ('audio recordings', 'Markdown documentation', 'summaries', 'LLM') but misses the most natural user phrases like 'transcribe', 'transcription', 'meeting minutes', 'speech-to-text', and common file extensions (mp3, wav).

3 / 5

Distinctiveness Conflict Risk

Audio-to-documentation is a fairly distinct niche with only minor overlap risk against generic summarization or documentation skills; not a 5 because the vague 'LLM integration' phrasing leaves the niche less sharply defined.

4 / 5

Total

13

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (555 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

skills/audio-transcriber/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.