Content
40%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 a clean, brief topic index in form, but it is hollow in substance: no executable guidance, no workflow, and — most seriously — all three of its local reference targets are missing from the bundle, leaving the progressive-disclosure structure pointing at nothing. The Vue/Angular/Svelte sections are purely outbound links with no local value-add.
Suggestions
Add the missing bundle files framework.md, player.md, and rendering.md (e.g. under references/) so the one-level-deep links actually resolve, or inline the minimal content they would carry.
Add a concrete quick-start snippet — an install command and a minimal composition example — so the skill is actionable without leaving SKILL.md.
Impose an order on the sections (choose template → build composition → preview with <Player> → render) so a newcomer can follow a sequence instead of a flat topic list.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~30-line body is lean with well-scoped sections and no explanation of concepts Claude already knows, close to anchor 5. It lands at 4 rather than 5 because of the contentless opener ("One can build apps with Remotion. It is possible to have a simple form and hook it up to a render...") and "We have several templates for SaaS which can be cloned or used as a reference", which add texture but not actionable information and could be trimmed. | 4 / 5 |
Actionability | The body contains no code, commands, or specific steps — it only describes capabilities ("This component allows embedding a Remotion preview in a React app") and points elsewhere, matching anchor 2 (high-level hints, missing steps to execute). It is not a 3 because there is not even partial concrete or executable guidance inline, and the three referenced files (framework.md, player.md, rendering.md) do not exist in the bundle, so the pointers resolve to nothing. | 2 / 5 |
Workflow Clarity | No sequence is presented anywhere — the body is a topic catalog, not a workflow; there is no "start here, then do this" ordering and no validation checkpoints, matching anchor 2 (rough topical order exists via section order — choosing a framework, Player, rendering — but steps are undefined and validation absent). The simple-skill exception does not apply: this skill spans multiple distinct tasks (templating, embedding, rendering, three alternative frameworks), so an unambiguous single action cannot justify a higher score. | 2 / 5 |
Progressive Disclosure | Per the guideline to score against the actual bundle structure, the three referenced files (framework.md, player.md, rendering.md) are absent from the bundle — there is no references/ or scripts/ directory, only assets/remotion-icon.svg. The SKILL.md has the correct overview-plus-one-level-links form, but every local link is dangling, so navigation is broken and the detailed content the structure promises does not exist, matching anchor 2. It is not a 1 because the section organization and clearly-signaled links are present and the external Vue/Angular/Svelte URLs do resolve as remote docs. | 2 / 5 |
Total | 10 / 20 Passed |