CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

video-analyser

Analyses a video — usually a bug screen recording from a file, URL, or Linear ticket — with ffmpeg keyframes plus optional OCR and transcription, extracting errors, UI state, and repro steps. Triggers on "analyse this video", "analyze this recording", "what does this video show", "/video-analyser".

Quality

88%

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

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, well-sequenced pipeline document: concrete executable commands, explicit bail gates, fallback paths, and a user-confirmation checkpoint. The weaknesses are redundancy (the sheet-vs-split legibility rationale appears in at least four sections) and time-sensitive hardcoded pricing in the Token Budget tables, plus missed opportunities to move the cost tables and risk register into a separate reference file.

Suggestions

State the sheet-vs-split legibility tradeoff once (in the Frame Delivery Mode section) and reference it from Steps 5d, 6, and 8 instead of restating it in each place.

Move the Token Budget cost tables and Risks and Mitigations register into a references/ file (e.g. token-budget.md), keeping only the mode-selection decision rule in SKILL.md; this also fixes the hardcoded, time-sensitive 'Sonnet 4.6, $3/M' pricing.

Add the primary use case to the trigger list in the description — e.g. "analyze this screen recording" or "what's happening in this recording" — since screen recordings are the skill's stated typical input.

DimensionReasoningScore

Conciseness

The pipeline commands and ffmpeg gotchas (e.g. "-frames:v 1 is required", "scale=768:trunc(ow/a/2)*2") are non-obvious and earn their place, but the sheet-vs-split legibility rationale is repeated across at least four sections (intro, Step 5d, Step 6, Token Budget/Risks) and the cost tables hardcode time-sensitive pricing ("Sonnet 4.6, $3/M"), which the rubric flags as a conciseness penalty. This fits 'mostly efficient but could be tightened' better than 'minor instances of over-explanation'.

3 / 5

Actionability

Every stage has copy-paste-ready bash (probe, keyframe extraction, uniform fill, montage, OCR loop, audio extraction), exact verbatim bail messages, complete analysis-prompt templates for both delivery modes, and an exact output schema — covering the common cases fully with executable code throughout.

5 / 5

Workflow Clarity

Steps 1–9 are explicitly sequenced with validation checkpoints throughout: tool detection before any work, ffprobe metadata before frame work, ordered bail gates in Step 3, a webm keyframe fallback, and a genuine feedback loop in Step 4 ("Wait for explicit confirmation. If the user does not confirm, fall back to N=16"). The destructive/batch cap does not apply to this read-only analysis pipeline.

5 / 5

Progressive Disclosure

There are no bundle files at all (no references/, scripts/, or assets/), so everything lives in a ~470-line SKILL.md. Section structure is good with clear headers, decision tables, and a step sequence, but the ~40-line Token Budget cost tables and the Risks and Mitigations table are candidates to offload into a reference file for a leaner core — minor organization gaps rather than the well-signaled one-level-deep reference structure of the top anchor.

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: it states the method, the inputs (including the Linear-ticket integration), the concrete outputs, and explicit trigger phrases in third person. The only weakness is that natural trigger phrasing for screen recordings — the skill's own stated primary input — is not among the listed triggers.

DimensionReasoningScore

Specificity

The description enumerates concrete actions (ffmpeg keyframe extraction, optional OCR, optional transcription) and concrete outputs ("extracting errors, UI state, and repro steps") with no meaningful coverage gap, matching the comprehensive-coverage anchor rather than the 'minor gaps' anchor below it.

5 / 5

Completeness

It clearly answers both 'what' ("Analyses a video… extracting errors, UI state, and repro steps") and 'when' with an explicit trigger clause ("Triggers on…"), matching the anchor requiring concrete trigger phrases; the cap for missing trigger guidance does not apply.

5 / 5

Trigger Term Quality

Triggers include both spellings ("analyse this video", "analyze this recording") and a natural question form ("what does this video show"), but common natural terms for its primary use case are missing — e.g. "screen recording" (which the description itself names as the typical input), "bug recording", or "what's happening in this video" — so coverage is good rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

The niche is distinct — bug screen-recording analysis from a file, URL, or Linear ticket — and the trigger phrases are unambiguously video-specific, so overlap with other skills is minimal.

5 / 5

Total

19

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

mthines/agent-skills

Path

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