CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

videodb

Ingest, index, search, edit, and monitor video and audio with the VideoDB Python SDK — upload from files, URLs, or RTSP feeds, build spoken and scene indexes with timestamped search and playable clips, transcode and reframe, do timeline edits (subtitles, overlays, dubbing), and run real-time alerts on live streams or desktop capture. Use when working with video search, transcription, clipping, transcoding, streaming, or live video alerts.

Quality

83%

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

75%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 is highly actionable — executable code for every operation, exact error-message-to-fix mappings, and validation rules for fragile steps like timeline timestamp handling. Its one serious defect is that the entire progressive-disclosure layer is broken in the delivered bundle: all 10 "Additional docs" links and the "see reference/capture.md" pointer resolve to files that are not present, leaving only scripts/ws_listener.py real.

Suggestions

Ship the 10 referenced reference/*.md files (api-reference.md, search.md, editor.md, streaming.md, generative.md, rtstream.md, rtstream-reference.md, capture.md, capture-reference.md, use-cases.md) in the skill bundle, or remove the links and inline the essential content — as delivered, every link under "Additional docs" and the "see reference/capture.md for the full workflow" pointer is dangling.

Add verification checkpoints for async operations: show how to check the status of the job_id returned by conn.transcode() and what a reframe callback_url webhook payload looks like, so async workflows have explicit completion steps.

Trim the generic inline-Python/heredoc formatting guidance in "Running Python code" and fold the "When to use what" table into the existing "When to use" section to remove duplicated content.

DimensionReasoningScore

Conciseness

The body is mostly SDK-specific and token-efficient (pitfalls table, error-recovery idioms, reframe timeout warnings), but "Running Python code" teaches generic inline-Python/heredoc formatting Claude already knows ("use semicolons to separate statements... use a heredoc instead"), and the "When to use what" table partially duplicates the "When to use" section. Minor instances of over-explanation hold it at 4 rather than 5.

4 / 5

Actionability

Every section ships executable, copy-paste-ready code — upload variants (URL/YouTube/file), search wrapped in try/except InvalidRequestError, the scene-index regex idiom, Timeline/VideoAsset construction, transcode with VideoConfig/AudioConfig, three reframe variants — plus a pitfalls table mapping exact error messages ("Spoken word index for video already exists") to fixes. Fully executable with common cases and edge handling covered.

5 / 5

Workflow Clarity

Setup and desktop capture are clearly sequenced (numbered steps 1–5 with STATE_DIR, listener start, ws-id check, events file), and fragile operations carry explicit validation ("start must be >= 0", "start must be < end", "end must be <= video.length") and feedback loops (catch the scene-index error, extract the id, proceed). Gaps remain — transcode returns job_id and async reframe returns None with no job-status verification example — so it sits at 4 rather than 5.

4 / 5

Progressive Disclosure

The overview is well designed with clearly-signaled, one-level-deep references ("reference/api-reference.md — Complete VideoDB Python SDK API reference", etc.), but none of the 10 referenced reference/*.md files exist in the delivered bundle — only scripts/ws_listener.py resolves — so the "Use the Glob tool to locate it" fallback finds nothing and navigation to the detailed material is broken. Scored against the actual bundle structure, dangling reference paths fall below the 3 anchor, where references at least resolve.

2 / 5

Total

15

/

20

Passed

Description

88%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 explicitly states both what the skill does (with concrete, comprehensive operations from ingest to live alerts) and when to use it, in third person, without padding. Its only weaknesses are a trigger list missing natural synonyms (subtitles, captions, screen recording) and slight overlap risk on the broad terms "transcription" and "streaming".

DimensionReasoningScore

Specificity

Names many concrete operations — "upload from files, URLs, or RTSP feeds", "build spoken and scene indexes with timestamped search and playable clips", "transcode and reframe", "timeline edits (subtitles, overlays, dubbing)", "run real-time alerts on live streams or desktop capture" — covering ingest through monitoring comprehensively. Not 4: the action list spans the full capability surface with no notable gaps in coverage.

5 / 5

Completeness

Explicitly answers both halves: the "what" via the detailed capability list ("Ingest, index, search, edit, and monitor video and audio...") and the "when" via "Use when working with video search, transcription, clipping, transcoding, streaming, or live video alerts." Matches the 5 anchor — concrete trigger phrases accompany both what and when.

5 / 5

Trigger Term Quality

"Use when working with video search, transcription, clipping, transcoding, streaming, or live video alerts" supplies natural phrases users would say, but common terms like "subtitles", "captions", "screen recording", and "resize video" are absent. Good coverage with a few natural terms missing matches the 4 anchor rather than 5's synonym-and-variation completeness.

4 / 5

Distinctiveness Conflict Risk

The "VideoDB Python SDK" framing and video-specific operations establish a clear niche, but broad triggers like "transcription" and "streaming" could fire for generic transcription or streaming skills. Mostly distinct with minor overlap risk against closely related skills matches 4 rather than 5's minimal-conflict bar.

4 / 5

Total

18

/

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

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 10 missing

Warning

Total

13

/

16

Passed

Repository

affaan-m/ECC

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.