CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

transcript

Extract transcripts from URLs or local video/audio files. Use when the user asks for a transcript, subtitles, or to transcribe media.

Quality

90%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

An exemplary instruction-only skill body: lean, fully actionable, with explicit routing, validation checkpoints, error-stop policy, and safe guards around deletion. Bundle structure matches every referenced path and flag, and progressive disclosure is clean at exactly one level deep.

DimensionReasoningScore

Conciseness

The body is ~50 lines of dense operational rules — selection preferences, routing, one command, output and deletion policy — with no concept explanations and no padding. Every sentence instructs rather than explains, matching the 'lean and efficient; every token earns its place' anchor.

5 / 5

Actionability

The cleanup command is concrete and executable ('node "<skill-dir>/scripts/strip-transcript.mjs" "<subtitle-file>" > "<run-dir>/transcript.txt"') with explained flags whose behavior was verified against the actual script, and routing conditions are specific and testable. Placeholders are explicitly defined ('Use its absolute path as <run-dir>'), so the guidance is copy-paste ready rather than pseudocode.

5 / 5

Workflow Clarity

The sequence is explicit with branching (URL returns subtitles → clean; returns media → go directly to recognition) and includes validation checkpoints: 'Check command errors and confirm this run produced a transcript containing text. Report empty results rather than claiming success', plus a stop-and-report error policy. Because validation precedes the destructive cleanup-deletion step and playlist/batch handling is addressed, the destructive/batch cap does not apply.

5 / 5

Progressive Disclosure

SKILL.md is a clear overview that routes to one-level-deep, well-signaled references ([URL transcripts](references/url.md), [Local transcripts](references/local.md#speech-recognition)) that exist on disk with matching headings, plus a bundled script. Content is appropriately split with nothing inlined that belongs in a reference.

5 / 5

Total

20

/

20

Passed

Description

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

A concise, well-structured description with an explicit 'Use when' trigger clause and natural trigger terms. Its main weakness is thin capability coverage — only one action verb — plus a slight overlap risk from the 'subtitles' trigger and missing synonyms like 'captions'.

Suggestions

Add a second concrete capability to the 'what' clause, e.g. 'Extract transcripts from URLs or local video/audio files via embedded subtitles or speech recognition', to lift specificity beyond a single action.

Include additional natural trigger synonyms such as 'captions' or file extensions like '.srt' / '.vtt' in the 'Use when' clause.

Disambiguate the 'subtitles' trigger, e.g. 'when the user asks for a transcript, subtitles as text, or to transcribe media', to reduce overlap with subtitle-download/editing skills.

DimensionReasoningScore

Specificity

"Extract transcripts from URLs or local video/audio files" names the domain and one concrete action (extracting transcripts) across two input types, but does not enumerate the skill's other operations such as subtitle cleanup or speech recognition. It sits at the 'names domain and 1-2 concrete actions' anchor, not score 4, because there is no list of several distinct actions.

3 / 5

Completeness

It explicitly answers both parts: what ("Extract transcripts from URLs or local video/audio files") and when ("Use when the user asks for a transcript, subtitles, or to transcribe media") with concrete trigger phrases. This directly matches the score-5 anchor; the 'when' clause is explicit, not implied, ruling out score 4.

5 / 5

Trigger Term Quality

The description includes the natural phrases users would say — "transcript", "subtitles", "to transcribe media" — giving good synonym coverage. It falls short of score 5 because common variations like "captions" and file extensions (.srt, .vtt) are missing.

4 / 5

Distinctiveness Conflict Risk

Transcription of media is a clear niche with mostly distinct triggers, but the trigger term "subtitles" could also fire for requests to download or edit subtitle files, a closely related skill. Minor overlap risk places it at the 'mostly distinct' anchor rather than the minimal-conflict score 5.

4 / 5

Total

16

/

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

shillem/cc-marketplace

Path

plugins/transcript/skills/transcript/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.