Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured, highly actionable porting workflow with strong progressive disclosure and a genuine validate→fix feedback loop. The only weakness is moderate redundancy in restating the skill's scope exclusions across multiple sections, which slightly dilutes token efficiency.
Suggestions
Collapse the repeated scope-exclusion messaging: state the one-way / Remotion-only / non-Remotion-source exclusions once (e.g. in 'When to use') and have the closing 'What this skill explicitly does NOT do' section reference it rather than re-explain, since the description already covers the same ground.
Trim the opening blockquote, which restates trigger guidance already present in the description and the 'When to use' section; a one-line pointer would preserve the route-confirmation cue at lower token cost.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean and actionable, but the scope-exclusion messaging (one-way Remotion-only, Do-NOT-use, NOT SUPPORTED) is restated across the opening blockquote, 'When to use', and 'What this skill explicitly does NOT do' — and largely duplicates the description — so it could be tightened. Not a level 3 because the redundancy is noticeable; not a level 1 because it never explains concepts Claude already knows. | 2 / 3 |
Actionability | Provides fully executable commands (`npx remotion render <CompositionId> out/baseline.mp4`, `npx hyperframes render --skill=remotion-to-hyperframes --output ../hf.mp4`, `scripts/render_diff.sh ...`), a concrete emit spec for `index.html` with named `data-*` attributes, and copy-paste config (`Config.setVideoImageFormat("png")` + `Config.setColorSpace("bt709")`). | 3 / 3 |
Workflow Clarity | A clear five-step sequence (Lint→Plan→Generate→Validate→Document) with a hard stop-condition in Step 1 ('If any blocker fires, stop') and an explicit validate→diagnose→retry loop in Step 4 ('If the diff fails, run frame_strip.sh ... then re-read the relevant reference'). | 3 / 3 |
Progressive Disclosure | SKILL.md is an overview that delegates detail to one-level-deep references via a 'Source contains → Load reference' table; all 11 referenced markdown files, the 3 scripts, and assets/test-corpus/run.sh exist on disk, and the full API map is offloaded to references/api-map.md rather than inlined. | 3 / 3 |
Total | 11 / 12 Passed |