videodb-skills

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

Quality

53%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/videodb-skills/SKILL.md

Quality

Content

32%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill reads more like a product README or marketing landing page than an actionable skill for Claude. It lists capabilities and example user prompts but provides zero executable SDK code, no multi-step workflows, and no references to detailed documentation. The content tells Claude what VideoDB can do but never shows how to do it.

Suggestions

Add executable Python code examples for the core operations (upload, search, transcribe, edit) using the VideoDB SDK, showing actual API calls rather than natural language prompts.

Create detailed workflow sequences for multi-step operations like editing (trim → combine → overlay → validate → stream), including validation checkpoints and error handling.

Add bundle files or clear references to detailed documentation for each capability (e.g., EDITING.md, SEARCH.md, AI_GENERATE.md) so the SKILL.md serves as a navigable overview.

Remove marketing language and redundant sections (the 'When to Use' list largely duplicates the capabilities table) to improve conciseness.

Dimension	Reasoning	Score
Conciseness	The skill includes some unnecessary marketing language ('The only video skill your agent needs', '$20 free credits, no credit card') and the 'When to Use This Skill' section largely restates the capabilities table. The capabilities table itself is reasonable but the overall content could be tightened significantly.	3 / 5
Actionability	The skill provides no executable Python code examples — only natural language prompts showing what a user might say. There are no SDK code snippets demonstrating how to actually call VideoDB APIs (e.g., upload, search, transcribe). The setup steps are concrete but the core capabilities lack any actionable implementation guidance.	2 / 5
Workflow Clarity	The setup is sequenced (Steps 1-3), but there are no workflows for the actual video operations. Multi-step processes like editing (trim, combine, overlay) have no sequenced steps, no validation checkpoints, and no error handling guidance. For operations involving media processing and streaming, this is a significant gap.	2 / 5
Progressive Disclosure	No bundle files are provided, yet the skill references a GitHub repository and a '/videodb setup' command without explaining what they contain. The SKILL.md itself is a flat overview with no references to detailed documentation for any of the nine capabilities listed. All the detail that would make this skill useful is missing and not pointed to.	2 / 5
	Total	9 / 20 Passed

Description

75%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 excels at listing specific, concrete capabilities and is highly distinctive due to the named SDK and focused domain. Its main weakness is the lack of an explicit 'Use when...' clause, which would help Claude know exactly when to select this skill over others. The trigger terms are good but could benefit from additional synonyms and file extensions.

Suggestions

Add a 'Use when...' clause, e.g., 'Use when the user asks about video/audio processing, streaming, transcription, or mentions VideoDB.'

Include common file extensions and synonyms such as '.mp4', '.mp3', '.wav', 'media files', 'subtitles', or 'captions' to improve trigger term coverage.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions: upload, stream, search, edit, transcribe, and generate AI video and audio. Also names the specific tool (VideoDB SDK). Comprehensive coverage of capabilities.	5 / 5
Completeness	Has a clear and detailed 'what' (upload, stream, search, edit, transcribe, generate AI video/audio using VideoDB SDK), but there is no explicit 'when' clause. The absence of a 'Use when...' clause caps this at 3 per the rubric guidelines.	3 / 5
Trigger Term Quality	Includes strong natural keywords like 'video', 'audio', 'transcribe', 'stream', 'upload', and 'VideoDB SDK'. However, it's missing some natural user phrases like file extensions (.mp4, .mp3), synonyms like 'media files', or terms like 'subtitle', 'caption', 'clip'.	4 / 5
Distinctiveness Conflict Risk	Very distinct niche — VideoDB SDK is a specific tool, and the combination of video/audio operations (upload, stream, search, edit, transcribe, generate) with that SDK creates a clear, unique identity that is unlikely to conflict with other skills.	5 / 5
	Total	17 / 20 Passed

Validation

90%

Warnings & errors only

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

Validation — 10 / 11 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	10 / 11 Passed

Repository: administrakt0r/AI-Agents-Safe-Coding-Skills
Path: skills/videodb-skills/SKILL.md
Commit: 900c504

Reviewed: 4 hours ago

Table of Contents

Discovery Implementation Validation

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.