CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

video-analysis

Analisa videos, transcricoes e quadros para responder sobre seu conteudo. Trigger em: "transcrever video", "transcrever esse video", "baixar video do youtube", "extrair frames do video", "extrair frames desse video", "legenda automatica", "resumir video", "resumir esse video", "analisar video", "analisar o conteudo desse video", "o que acontece nesse video", "whisper", "yt-dlp", "transcription video", "extract frames from this video".

Quality

79%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/54-video-analysis/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%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 presents a clear, well-sequenced 3-step workflow with genuine validation checkpoints and feedback loops, and it is token-efficient with concrete strategy parameters. Its weaknesses are concentrated in actionability and progressive disclosure: the executable commands for the core flow are deferred to a guide file that does not exist in the bundle, and the setup script it instructs to run is likewise absent.

Suggestions

Include the core yt-dlp and ffmpeg commands inline (or ship `docs/skill-guides/video-analysis.md` in the bundle) so steps 1-3 are executable without relying on a file that is not present.

Add `scripts/setup-video-analysis.mjs` to the bundle, or replace the instruction to run it with the inline manual commands the script would print, so the setup step does not fail on a missing file.

Merge the "Regra Default" section into the Fluxo and Transcricao sections to remove the redundancy of restating defaults already stated there, tightening conciseness.

DimensionReasoningScore

Conciseness

The body assumes Claude's competence (no explanation of what ffmpeg/whisper are) and tokens like "~80 frames a 512px de largura ≈ 50-80k tokens" earn their place. Not 5 because "Regra Default" restates defaults already stated in the Fluxo and Transcricao sections, and "Entradas Esperadas" overlaps "Quando Usar"; not 3 because nothing explains known concepts.

4 / 5

Actionability

Setup is fully executable ("rodar `node scripts/setup-video-analysis.mjs`", "--check-only") and strategies carry concrete parameters (frame caps 50/100, 512px, mono/16kHz preprocessing), but the core steps 1-3 contain no executable yt-dlp/ffmpeg commands — they are deferred to `docs/skill-guides/video-analysis.md`, which is not in the bundle, so the actual commands are unreachable. Not 4 because the gap sits in the main workflow, not a minor detail; not 2 because tools, API keys, and preprocessing specifics are all named.

3 / 5

Workflow Clarity

"O Fluxo (3 passos, na ordem)" gives a clearly ordered sequence with conditional gating ("so se a pergunta for visual", "so se nao ha legenda") and an explicit per-step checkpoint with error-recovery feedback loops ("Frame extraido borrado/preto... volta pro passo 1", low-quality auto-caption "cai pro passo 3"). Not 4 because validation checkpoints and recovery loops are explicit rather than implied; the destructive/batch cap does not apply since download/extraction is non-destructive.

5 / 5

Progressive Disclosure

The body is well-sectioned and defers detail via a clearly signaled one-level reference ("consultar `docs/skill-guides/video-analysis.md` apenas quando necessario"), but no bundle files exist — both referenced paths (`docs/skill-guides/video-analysis.md` and `scripts/setup-video-analysis.mjs`) are missing from the bundle, so navigation and the deferred commands do not resolve. Not 4 because dangling references to a missing script and guide are more than a minor organization gap; not 2 because the body itself is structured, not a monolithic wall.

3 / 5

Total

15

/

20

Passed

Description

83%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 is strong: it states a clear capability, provides an explicit and extensive trigger list in natural user phrasing with good variation, and occupies a distinct niche. Main gaps are the generic lead verb and missing file-extension/English trigger coverage.

DimensionReasoningScore

Specificity

The trigger list enumerates several concrete actions ("transcrever video", "baixar video do youtube", "extrair frames do video", "legenda automatica", "resumir video"), going beyond 1-2 actions. The lead 'what' sentence ("Analisa videos, transcricoes e quadros para responder sobre seu conteudo") is a single generic verb, keeping it below the comprehensively detailed anchor-5 example.

4 / 5

Completeness

Explicitly answers both 'what' ("Analisa videos, transcricoes e quadros para responder sobre seu conteudo") and 'when' with a dedicated trigger clause ("Trigger em: 'transcrever video', ...") listing concrete trigger phrases — a direct match to the anchor-5 example. Not 4 because the 'when' is an explicit enumeration, not merely adequate.

5 / 5

Trigger Term Quality

Good natural-phrase coverage with variations ("transcrever video"/"transcrever esse video", "resumir video"/"resumir esse video", "o que acontece nesse video") plus tool names ("whisper", "yt-dlp"). Not 5 because file extensions (.mp4) and natural English equivalents are missing — "transcription video" and "extract frames from this video" are literal rather than natural.

4 / 5

Distinctiveness Conflict Risk

A clear video-analysis niche with distinct video-specific triggers makes wrong-skill firing unlikely. Not 5 because "whisper", "legenda automatica", and "resumir video" could overlap with an audio-transcription or general summarization skill; not 3 because the video framing is consistently specific.

4 / 5

Total

17

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

metadata_version

'metadata.version' is missing

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

13

/

16

Passed

Repository

felvieira/claude-skills-fv

Path

skills/54-video-analysis/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.