video-transcripts

Generate structured video transcripts from local files or video URLs using Gemini Files API. Use when a GitHub or Linear tracker item, comment, or attachment includes a screen recording, .mov, .mp4, or tracker-hosted video and you need a <video-transcripts> block instead of hand-written notes.

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

82%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, well-structured skill body with executable commands covering every common source and a detailed sequenced caching workflow. The main improvements are removing the Quick Start/Notes auth-detail duplication and pushing more internal helper mechanics into the bundled script.

Suggestions

Remove the duplicated auth-fallback hierarchies from either Quick Start or Notes; state them once and reference the helper for the full chain.

Move the Screencastify HLS manifest/ffmpeg remuxing detail out of Notes and into the bundled script (or a reference file), keeping SKILL.md to invocation and outcome.

Add an explicit validate-and-retry step in the Workflow for when helper output is malformed or thin, rather than relying only on the helper's automatic fallback.

Dimension	Reasoning	Score
Conciseness	The body is efficient and avoids explaining concepts Claude already knows, with tight sections and executable examples; minor redundancy between the Quick Start auth note and the Notes section (e.g., the Linear cookie and GitHub token fallback hierarchies are stated twice) keeps it just below the lean top anchor.	4 / 5
Actionability	Copy-paste-ready bash invocations are given for each common source (Linear, GitHub, Screencastify, local file) plus concrete env-var and flag overrides (VIDEO_TRANSCRIPTS_MODEL, --model, --debug-dir), fully covering the common cases.	5 / 5
Workflow Clarity	A clearly sequenced 17-step workflow with explicit cache-matching/reuse checkpoints (steps 14-15) and an automatic quality-gate fallback; it stops short of an explicit validate->fix->retry loop for the user-facing transcript step, so it is one level below the top anchor.	4 / 5
Progressive Disclosure	Well-organized into labeled sections with the heavy logic delegated to the bundled scripts/generate_video_transcript.sh (verified present), but the Notes section inlines internal helper behavior (cookie stores, Screencastify HLS remuxing) that arguably belongs in the script, a minor placement gap below the top anchor.	4 / 5
	Total	17 / 20 Passed

Description

82%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, third-person description that clearly states what the skill does and when to use it, with concrete file-extension and source-host triggers. It is slightly under-specified on the breadth of distinct actions, listing essentially one generate action with input variants.

Dimension	Reasoning	Score
Specificity	Names the domain and one core concrete action ('Generate structured video transcripts from local files or video URLs using Gemini Files API') with input variants, but does not list multiple distinct actions, so it sits at the '1-2 concrete actions, not comprehensive' anchor rather than the 'several specific actions' level above.	3 / 5
Completeness	Explicitly answers both 'what' ('Generate structured video transcripts ... using Gemini Files API') and 'when' ('Use when a GitHub or Linear tracker item, comment, or attachment includes a screen recording ... and you need a <video-transcripts> block') with concrete trigger phrases, matching the top anchor.	5 / 5
Trigger Term Quality	Good natural-term coverage including file extensions ('.mov', '.mp4', 'screen recording', 'tracker-hosted video') and source hosts (GitHub, Linear); a few common synonyms like 'transcribe' or bare 'video' are implied but not all explicit, keeping it just below the comprehensive anchor.	4 / 5
Distinctiveness Conflict Risk	Clear niche tied to tracker-hosted screen recordings and a specific output shape (<video-transcripts>), with distinct triggers that make overlap with generic transcription skills minimal.	5 / 5
	Total	17 / 20 Passed

Validation

93%

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 — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
relative_links	Relative link issues: 1 missing, 2 suspicious	Warning

	Total	15 / 16 Passed

Repository: udecode/plate
Path: templates/plate-playground-template/.agents/skills/video-transcripts/SKILL.md
Commit: babb3c2

Reviewed: 2 days 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.