CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

video-transcripts

Transcribe a supplied local or linked video with Gemini, or from its frames with a Claude subagent when Gemini fails, and check the transcript against one frame per second, when a recording's contents are needed as evidence, such as a bug recording on an issue, PR or comment, or a question about what a video shows.

Quality

88%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

A highly actionable skill body with unusually strong verification discipline — explicit frame-checking validation, fallback paths, and a quality gate with defined thresholds. Its weaknesses are redundancy (duplicated examples and auth details) and dated benchmark/model-version detail in the main flow, which hurt token efficiency, plus a monolithic structure that inlines some minutiae a reference file could hold.

Suggestions

Collapse the four near-identical Quick Start invocations into one example plus a note that the helper accepts a local path or a Linear/GitHub/Screencastify URL, saving three duplicated bash blocks.

Move the dated benchmark narratives and competitor-model comparisons out of the main flow (or into a clearly labeled evaluation-notes section), keeping only the operative policy: default model, fallback model, and quality-gate thresholds.

State the auth fallback chain (Linear cookies, GitHub tokens, Gemini key lookup) once — currently it appears in both the Quick Start prose and the Notes section.

DimensionReasoningScore

Conciseness

No concept over-explanation, but the body could be noticeably tightened: four near-identical Quick Start bash invocations, auth/env-var details duplicated between Quick Start and Notes, and dated benchmark narratives ('2026-11-05', per-model trivia like 'added a space after a full-width mark') sitting in the main flow rather than a clearly-labeled section. Not 4 because the redundancy and time-sensitive detail exceed minor trimming; not 2 because nothing explains what Claude already knows.

3 / 5

Actionability

Fully executable throughout: exact bash commands with flags, env-var precedence chains (LINEAR_COOKIE_HEADER then LINEAR_COOKIES_DB; GEMINI_API_KEY then GOOGLE_API_KEY), the Screencastify API endpoint, frame naming conventions (tSSSS.png, sheet-SSSS-SSSS.png), exit-code semantics (exit 3 → Frames fallback), and a copy-paste cache comment template. Covers the common cases completely.

5 / 5

Workflow Clarity

The 18-step workflow is clearly sequenced with an explicit, central validation checkpoint (step 3: check every line against the frames, rewrite disagreements, delete contradictions, mark unverifiable lines '(unverified)') and real feedback loops: exit 3 routes to the Frames fallback, and the quality gate retries with a fallback model on thin or repetitive transcripts. Not 4 because validation is explicit and load-bearing rather than mostly-present with minor gaps.

5 / 5

Progressive Disclosure

Scored against the actual bundle: two real scripts (generate_video_transcript.sh, video_frames.sh) are clearly referenced by exact path and carry the heavy lifting, with well-organized sections and no nested references. Not 5 because deep operational minutiae (Screencastify HLS remux details, cookie store paths, model benchmark trivia) is inlined in one ~180-line SKILL.md where a reference file or the script's own docs would keep the overview leaner.

4 / 5

Total

17

/

20

Passed

Description

92%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 strong description: third-person, concrete, and explicit about both capability and trigger conditions, with specific examples of when evidence transcription is needed. The only notable gap is missing the most natural trigger phrasing users would say, such as 'screen recording' or 'screencast'.

DimensionReasoningScore

Specificity

Lists multiple concrete actions covering the full pipeline — 'Transcribe a supplied local or linked video with Gemini', 'from its frames with a Claude subagent when Gemini fails', and 'check the transcript against one frame per second' — with comprehensive coverage of the domain. Not 4 because no meaningful action gaps remain for this niche.

5 / 5

Completeness

Explicitly answers both questions: the what is the transcribe/fallback/verify pipeline, and the when is a concrete trigger clause — 'when a recording's contents are needed as evidence, such as a bug recording on an issue, PR or comment, or a question about what a video shows'. Not 4 because the when-clause is already specific with concrete trigger phrases, not merely present.

5 / 5

Trigger Term Quality

Good natural-term coverage: 'video', 'recording', 'bug recording', 'transcript', 'a question about what a video shows', 'issue, PR or comment'. Not 5 because the most natural user phrasing 'screen recording'/'screencast' and file extensions are absent, though every present term is one a user would actually say.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche (video-as-evidence transcription with frame verification) with distinct triggers ('bug recording', 'what a video shows') that few other skills would claim. Not 4 because overlap risk with generic media skills is minimal, not minor-but-real.

5 / 5

Total

19

/

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

relative_links

Relative link issues: 1 missing, 2 suspicious

Warning

Total

15

/

16

Passed

Repository

udecode/plate

Path

.agents/skills/video-transcripts/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.