Content
63%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 SKILL.md body is a clean, token-efficient index with excellent per-rule scoping labels, but it delegates 100% of the actual guidance to rules/*.md files that are missing from the bundle, leaving the skill with no usable content and every reference dead-ending. Adding a minimal inline quick-start and shipping the rule files would resolve the main gaps.
Suggestions
Ship the rules/*.md files in the skill bundle — all 28 referenced paths are absent, so every link in the index dead-ends and the skill delivers no guidance on its own.
Add a brief inline quick-start (e.g. one minimal composition with useCurrentFrame() interpolation) or a 'most common rules' callout so the skill is actionable without opening a rule file.
Group the 28 rule links by category (e.g. media, animation/interpolation, captions/text, tooling) and trim the filler phrase 'to obtain the domain-specific knowledge' from the When to Use section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean ~35-line index: one 'When to Use' sentence ('Use this skills whenever you are dealing with Remotion code') plus a 28-item list where each line earns its place. Only minor trim candidates exist, e.g. the filler phrase 'to obtain the domain-specific knowledge' — this matches anchor 4 ('efficient; minor instances that could be trimmed') rather than 5, and is far from the verbose anchor 1 pattern of explaining concepts Claude already knows. | 4 / 5 |
Actionability | The guidance is concrete at the navigation level ('Read individual rule files for detailed explanations and code examples') with a specific file and one-line scope per topic (e.g. 'rules/trimming.md - Trimming patterns for Remotion - cut the beginning or end of animations'), but there is no executable code, command, or quick-start inline, and none of the referenced rules/*.md files exist in the bundle, so the instruction cannot actually be executed. This sits at anchor 3 ('some concrete guidance but incomplete; missing key details'), below anchor 4 whose guidance is executable end-to-end. | 3 / 5 |
Workflow Clarity | As a simple single-action skill the sequence is clear: trigger on 'dealing with Remotion code', then read the rule file matching the task — each list entry maps a concrete scenario to a file, making the single action mostly unambiguous. It falls short of 5 because with 28 undifferentiated entries, no prioritization or quick-start pointer, and referenced files that are absent, the workflow dead-ends; no validation steps are needed since this is a non-destructive reference skill. | 4 / 5 |
Progressive Disclosure | Structurally the body is a textbook overview: 'Read individual rule files...' followed by 28 clearly signaled, one-level-deep references each with a descriptive label. However, scoring against the actual bundle, none of the 28 referenced rules/*.md files (nor any references/, scripts/, or assets/ directories) exist — every link is broken, so the disclosure structure is only nominal and navigation is unverifiable. This lands at anchor 3: good structure on paper, significant reference gaps in practice, below anchor 4 where content is appropriately placed and references actually resolve. | 3 / 5 |
Total | 14 / 20 Passed |