CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

videodb

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

Quality

75%

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/videodb/SKILL.md

The canonical home for this skill is videodb in affaan-m/ECC

SKILL.md
Quality
Evals
Security

Quality

Content

71%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-organized, highly actionable quick-reference body with strong validation checkpoints and error-recovery guidance for the core video workflows. Its weaknesses are the absent reference/ file layer that the body's navigation depends on, and the lack of any inline example for the live-stream alerting capability the description advertises.

Suggestions

Ship the reference/ directory with the skill (or fix/remove the ten links) so the "Additional docs" navigation actually resolves, and reconcile the Provenance path (skills/videodb/reference/) with the linked reference/ paths.

Add a minimal inline RTSP ingest + alert example (connect feed, attach alert rule, receive events) since this headline capability currently has no executable guidance in the body or bundle.

De-duplicate error-handling guidance between code comments and the pitfalls table — keep the inline comments short and let the table carry the solutions.

DimensionReasoningScore

Conciseness

The body is dense and useful — quick-reference code blocks, a pitfalls table, and per-task recipes with no filler explaining concepts Claude already knows. Minor trimmable instances remain: the connect boilerplate appears in two full code blocks, "use semicolons to separate statements and keep it readable" over-explains basics, and error-handling guidance (force=True, scene-index regex, reframe timeouts) is stated both in code comments and again in the pitfalls table.

4 / 5

Actionability

Mostly executable, copy-paste-ready Python covers upload, transcript/subtitles, spoken and scene search with proper exception handling, timeline editing with asset imports, transcode with full config objects, reframe with async patterns, and image generation. The gap keeping it from 5: headline capabilities "create real time alerts for events from live streams" and the desktop-capture SDK workflow have no executable inline code — they are delegated to reference files that are not present in the bundle.

4 / 5

Workflow Clarity

Setup and desktop-capture Quick Start are clearly numbered sequences with a fallback (install without capture extra on Linux) and a data-hygiene checkpoint ("Use --clear whenever you start a fresh capture run"), and the timeline section has an explicit validation checklist ("start must be >= 0", "start must be < end", "end must be <= video.length") plus error-recovery loops in the try/except patterns and pitfalls table. It falls short of 5 because the RTSP/live-monitoring workflow is never sequenced in the body and per-task recipes are not tied into one end-to-end flow.

4 / 5

Progressive Disclosure

The "Additional docs" section is well designed — ten clearly signaled, one-level-deep links each with a one-line description — and scripts/ws_listener.py referenced in the body does exist. However, none of the ten referenced reference/*.md files (api-reference, search, editor, streaming, rtstream, capture, etc.) are present in the actual bundle, so the disclosure layer does not resolve, and the Provenance section contradicts the links by claiming material lives under skills/videodb/reference/.

3 / 5

Total

15

/

20

Passed

Description

71%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 dense, highly specific capability description that clearly communicates what the skill does across its See/Understand/Act domains. Its main weakness is the complete absence of explicit "when to use" trigger guidance, which caps completeness, and a few missing natural synonyms that would strengthen trigger matching.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user mentions video or audio files, streams, screen/desktop recording, subtitles or captions, clips, timestamps, transcoding, or monitoring live feeds for events."

Include natural synonyms and formats users actually say — "captions", "screen recording", "trim/merge clips", ".mp4/.mov" — so the description matches phrasings beyond the current vocabulary.

Trim the parenthetical parameter lists slightly (e.g. drop "(image, audio, video)") to free room for the trigger clause without growing the description.

DimensionReasoningScore

Specificity

The description lists many concrete actions with parameters — "ingest from local files, URLs, RTSP/live feeds", "build visual/semantic/temporal indexes", "transcode and normalize (codec, fps, resolution, aspect ratio)", "timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation)" — comprehensively covering ingest, indexing, search, editing, generation, and alerting. This matches the anchor for multiple specific concrete actions with comprehensive coverage, not the level below where minor gaps remain.

5 / 5

Completeness

The "what" is answered thoroughly (See/Understand/Act with detailed sub-capabilities), but there is no "Use when..." clause or equivalent explicit trigger guidance anywhere in the description. Per the judging guidelines, a missing trigger clause caps completeness at 3; it is not a 2 because the "what" is clear and detailed rather than vague.

3 / 5

Trigger Term Quality

Good natural-term coverage: "video", "audio", "subtitles", "search", "clips", "transcode", "resolution", "aspect ratio", "dubbing", "translation", "alerts" are phrases users would actually say. A few common variants are missing ("captions", "screen recording" vs the awkward "live record desktop", "trim"/"merge", file extensions like .mp4), so it does not reach the comprehensive synonym-and-extension anchor of 5.

4 / 5

Distinctiveness Conflict Risk

The video/audio-stream niche with distinctive triggers ("RTSP/live feeds", "playable stream links", "live record desktop", "scene indexing") is clearly distinguishable from most skills, with only minor overlap risk against generic media-editing/ffmpeg skills. It lacks the bullet-proof distinct trigger pairing of a 5 because broad terms like "generate media assets" and "translation" could collide with image-generation or translation skills.

4 / 5

Total

16

/

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

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 10 missing

Warning

Total

14

/

16

Passed

Repository

valeriibeck-star/claude-skills

Path

skills/videodb/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.