Content
96%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.
An exemplary operational skill body: lean, command-dense, with a validated multi-step workflow and clean one-level reference routing. The single structural defect is a missing referenced file (references/mixing.md) that leaves two pointers dangling.
Suggestions
Create references/mixing.md (or remove the "form in /media-use → references/mixing.md" pointers from media.md and limitations.md) so no reference in the bundle dangles.
Consider briefly mentioning the shipped test corpus (assets/test-corpus) in the body's verify step so its existence is discoverable without opening references/eval.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~46-line body is dense and operational throughout: a levels table, a five-step Native workflow, a routing table to reference files, and concrete gotchas ("without it every bordered or padded element grows by its border and padding", "or the diff measures the encoders (about 0.05 SSIM)"). Every token carries non-obvious porting knowledge and nothing explains concepts Claude already knows. | 5 / 5 |
Actionability | Commands are copy-paste ready with real flags and arguments: `python3 <SKILL_DIR>/scripts/lint_source.py <source dir>`, `npx hyperframes diff <original.mp4> . --at <t,…>`, `npx hyperframes catalog --query "…" --json`, `Config.setVideoImageFormat("png")`, and a concrete `<video class="clip" data-has-audio="true" src="assets/x.mp4">` snippet. Blockers are enumerated by exact name (useState, MUI, Chakra, delayRender) rather than described abstractly. | 5 / 5 |
Workflow Clarity | The Native path is a numbered sequence (lint → translate → keep editable → diff at sample times → full rendered diff → write TRANSLATION_NOTES.md) with explicit validation at each stage, blocker-handling guidance ("don't translate: host them or refactor them out, never approximate"), tiered diff thresholds deferred to references/eval.md, and a final-message checklist. The three-level decision table routes every source type to a well-defined path. | 5 / 5 |
Progressive Disclosure | The body is a clear overview with a well-signaled routing table mapping each Remotion API to a one-level-deep reference file, all of which exist in the bundle. However, `media.md` and `limitations.md` both point to `references/mixing.md`, which is absent from the bundle — a dangling second-level reference that breaks navigation, a minor organization gap against the top anchor. | 4 / 5 |
Total | 19 / 20 Passed |