CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

audio-transcriber

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

Quality

70%

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/antigravity-audio-transcriber/SKILL.md

The canonical home for this skill is audio-transcriber in sickn33/agentic-awesome-skills

SKILL.md
Quality
Evals
Security

Quality

Content

75%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 is a disciplined overview: concise, honest about limitations, with executable example commands and a well-signaled pointer to the detailed guide that carries the full procedure and validation steps. The main residual gaps are the deferred setup path and the unreferenced bundle files (notably tools-comparison.md) that a reader cannot discover from SKILL.md alone.

DimensionReasoningScore

Conciseness

The body is lean (~36 lines), assumes competence (no explanation of what Whisper or transcription is), and every section carries operational information. Minor instances could still be trimmed — e.g. the hedging sentences "OS ACL behavior is unverified" and "No installation, upload, sharing or distribution is implied by a transcription request" in Limitations — so it fits 'efficient; minor instances of over-explanation that could be trimmed' rather than the every-token-earns-its-place level 5.

4 / 5

Actionability

Two complete, copy-paste-ready bash commands with all flags shown (--output-dir, --llm none / --llm claude) and the conditions for each stated ("dependencies installed in the selected interpreter and an existing private output directory"). It is not 5 because the zero-to-running setup path (scripts/install-requirements.sh, model selection) is deferred to the referenced guide, leaving a minor gap between SKILL.md alone and a working invocation.

4 / 5

Workflow Clarity

The core sequence (install deps in the selected interpreter → ensure private output dir → run transcribe.py → optionally --llm claude) is present with a clearly gated optional step, and the body mandates the guide's "safety, prerequisites, and validation requirements" — which contains explicit verification (inspect transcript against the source, report only files actually generated). It is not 5 because the body itself has no inline numbered steps or explicit validate/recover checkpoints; those live one level deep in the guide.

4 / 5

Progressive Disclosure

The body is well-organized into clear sections and points to references/detailed-guide.md — a real file, one level deep, clearly signaled with guidance on when to read it fully vs. by section. It is not 5 because the bundle also contains references/tools-comparison.md, scripts/install-requirements.sh, and scripts/transcribe.py, none of which (tools-comparison.md especially) are referenced or discoverable from SKILL.md, leaving a minor navigation gap.

4 / 5

Total

16

/

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 niche and a coherent 'what', but it reads as a marketing-style headline: buzzword padding ("professional", "intelligent"), no explicit trigger guidance, and none of the natural keywords ("transcribe", "transcription", "speech-to-text", "meeting minutes", file formats) users would actually say when they need this skill.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to transcribe audio/video files, generate meeting minutes or transcripts from recordings, or summarize long audio content."

Include natural trigger terms and synonyms — "transcribe", "transcription", "speech-to-text", "meeting minutes" — and the supported file formats (MP3, WAV, M4A, OGG, FLAC, WEBM) that the body already lists.

Replace the fluff words "professional" and "intelligent" with concrete capability statements such as "Generates timestamped Markdown transcripts and optional LLM-generated executive summaries."

DimensionReasoningScore

Specificity

The description names the domain ("audio recordings") and roughly two actions ("Transform audio recordings into professional Markdown documentation", "intelligent summaries using LLM integration"), but the actions are stated abstractly and padded with fluff ("professional", "intelligent") rather than crisp concrete capabilities like transcribing or generating meeting minutes. It matches the 'names domain and 1-2 concrete actions, but not comprehensive' anchor; the score-4 anchor requires several specific listed actions, which this lacks.

3 / 5

Completeness

The 'what' is clear (transform audio recordings into Markdown documentation with LLM summaries), but there is no 'Use when...' clause or equivalent trigger guidance anywhere in the description, which caps completeness at 3 per the rubric guideline. It is not 2 because the 'what' is specific and coherent, not vague.

3 / 5

Trigger Term Quality

Relevant keywords exist ("audio recordings", "summaries", "Markdown documentation", "LLM"), but the most natural user phrases — "transcribe", "transcription", "speech-to-text", "meeting minutes", and common file formats (MP3, WAV) — are entirely absent. This fits 'some relevant keywords but missing common variations or synonyms'; it is not 4 because the single most natural trigger term ("transcribe") is missing altogether.

3 / 5

Distinctiveness Conflict Risk

The audio-recording-to-documentation niche is mostly distinct and unlikely to trigger for unrelated skills. It is not 5 because without the word "transcribe" and with the broad phrases "professional Markdown documentation" and "LLM integration", there is minor overlap risk with generic document-generation or summarization skills.

4 / 5

Total

13

/

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

boisenoise/skills-collections

Path

skills/antigravity-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.