Content
81%Weight 40%Scale 1-5Reviews 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, with executable code, explicit validation rules, and strong error-recovery guidance, and it is largely free of padding. However, its progressive-disclosure architecture is broken as shipped: ten referenced reference/*.md files are absent from the bundle, leaving workflows that depend on them (notably desktop capture) incomplete.
Suggestions
Ship the ten reference/*.md files listed under 'Additional docs', or remove the dead links and inline the critical content — especially the desktop-capture workflow, which currently depends on the missing reference/capture.md and is unusable without it.
Trim the opening capability sections (1-5) and 'Common inputs/outputs', which largely restate the frontmatter description, to reduce token cost.
Add a build-time existence check for every referenced bundle path so referenced files are guaranteed to ship with the skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dominated by VideoDB-specific knowledge Claude cannot already know (SDK quirks like 'index_scenes() has no force parameter', exact error strings, a pitfalls table) with almost no concept re-teaching; the opening capability sections 1-5 plus 'Common inputs'/'Common outputs' partially restate the frontmatter description and could be trimmed, which keeps it just below fully lean. | 4 / 5 |
Actionability | Copy-paste-ready executable examples cover the common cases: 'coll.upload(url=...)', 'video.index_spoken_words(force=True)', search wrapped in 'try/except InvalidRequestError', Timeline construction with 'VideoAsset(asset_id=video.id, start=10, end=30)', 'conn.transcode(...VideoConfig(resolution=720...))', reframe presets, and exact install commands, plus a pitfalls table mapping real error messages to concrete fixes. | 5 / 5 |
Workflow Clarity | Sequences are explicit (numbered capture Quick Start, install-then-configure-key setup) with validation checkpoints ('start must be >= 0', 'start must be < end', 'end must be <= video.length'), feedback loops for error recovery (extract 'scene_index_id' from the error and re-raise otherwise; treat 'No results found' as 'shots = []'), and a checklist-style pitfalls table. | 5 / 5 |
Progressive Disclosure | The 'Additional docs' section is well-formatted with one-line descriptions, but scored against the actual bundle none of the ten referenced 'reference/*.md' files exist — only 'scripts/ws_listener.py' ships — so nearly every navigation path dead-ends and the capture workflow's stated dependency (reference/capture.md) is unavailable. Not 3: the failure is not unclear signaling but non-functional navigation; not 4: the referenced files are simply missing. | 2 / 5 |
Total | 16 / 20 Passed |