CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

video-understand

Understand video content locally using ffmpeg frame extraction and Whisper transcription. No API keys needed. Use when: (1) Understanding what a video contains, (2) Transcribing video audio locally, (3) Extracting key frames for visual analysis, (4) Getting video content without API keys.

73

Quality

92%

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

92%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 well-structured, highly actionable body: executable commands covering all modes and options, clear mode-selection guidance with an automatic fallback, and clean progressive disclosure with a single real reference file. The only trim opportunity is the inline JSON output example that duplicates the output-format reference.

Suggestions

Trim the inline JSON example to a minimal skeleton (e.g., 3-4 keys) since references/output-format.md already documents the full schema.

Add a one-line note on handling long videos (e.g., when to lower --max-frames or use interval mode) to preempt the most likely user adjustment.

DimensionReasoningScore

Conciseness

The body is lean — a commands block, two compact tables, and short usage notes with no explanations of concepts Claude already knows. It falls short of anchor 5 because the 17-line inline JSON output example (lines 72-88) duplicates content already covered by 'references/output-format.md', which the same section points to and could be trimmed to a minimal skeleton.

4 / 5

Actionability

Every command is copy-paste ready and covers the common cases — default run, all three extraction modes, frame limits, whisper model size, skipping transcription, quiet mode, and file output — plus a complete CLI options table and prerequisites with install commands. This matches anchor 5's 'fully executable; specific examples cover the common cases'.

5 / 5

Workflow Clarity

This is a simple, single-action skill (run the script) where the single action is unambiguous, meeting the simple-skill exception in the scoring notes. The flow is complete: prerequisites with install commands, mode selection with best-for guidance, an automatic scene-to-interval fallback documented, and an explicit post-run step ('Use the Read tool on frame image paths to visually inspect extracted frames').

5 / 5

Progressive Disclosure

The body is a clear overview with one well-signaled, one-level-deep reference ('references/output-format.md', which exists and contains no nested references), and the implementation script lives in scripts/. Content is appropriately split — the full output schema is in the reference while only a sample sits inline — making navigation easy, matching anchor 5.

5 / 5

Total

19

/

20

Passed

Description

87%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 that clearly states what the skill does, names its concrete mechanisms (ffmpeg frame extraction, Whisper transcription), and provides an explicit numbered Use-when list of trigger scenarios. The only gaps are missing synonyms and file extensions in the trigger terms.

Suggestions

Add file extensions or synonyms to the trigger terms, e.g., 'Use when the user mentions .mp4/.mov files, captions, or summarizing what happens in a video.'

Mention the scene-detection capability (a headline feature) in the description to broaden trigger coverage without adding vagueness.

DimensionReasoningScore

Specificity

The description names concrete actions with specific tools — 'using ffmpeg frame extraction and Whisper transcription', 'Extracting key frames for visual analysis', 'Transcribing video audio locally' — going beyond the anchor-3 example of 1-2 actions. It falls short of anchor 5 because it doesn't comprehensively cover capabilities like scene detection or different extraction modes, leaving minor gaps in coverage.

4 / 5

Completeness

It explicitly answers both questions: 'what' via 'Understand video content locally using ffmpeg frame extraction and Whisper transcription' and 'when' via a numbered 'Use when:' list with four concrete trigger phrases. This matches the anchor-5 good example's structure of clear what plus explicit when clauses, and clearly exceeds anchor 4 (where the 'when' could be more explicit).

5 / 5

Trigger Term Quality

Natural trigger phrases like 'Understanding what a video contains', 'Transcribing video audio', and 'key frames' would match how users phrase these requests. It falls short of anchor 5's comprehensive coverage because it omits common synonyms and file extensions (e.g., .mp4, .mov, 'captions', 'video-to-text').

4 / 5

Distinctiveness Conflict Risk

Video understanding via ffmpeg/Whisper is a clear niche with distinct triggers ('video content', 'video audio', 'key frames'), occupying minimal overlap with adjacent skills like image or audio-only processing. The 'No API keys needed' framing further distinguishes it from cloud-based transcription skills.

5 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

calesthio/OpenMontage

Path

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