Content
92%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 exceptionally well-structured orchestration skill: fully executable commands, per-step validation gates with error-recovery feedback loops, and clean one-level-deep references backed by an actual bundle whose file listing matches the cited paths. The only nit is light repetition of the orchestrator framing and routing rules.
Suggestions
Remove the duplicate 'You are the orchestrator' framing (lines ~16 and ~18) and consolidate the intent-routing rules so they appear once rather than in both the intro and Step 0's opening rule.
A few long guardrail sentences (e.g. the full-bleed background explanation and the auth exit-code contract) could be tightened to their essential condition without losing the contract.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense and procedural throughout, with virtually no generic-concept padding (no 'what a video is' filler) and every line carrying domain-specific orchestration knowledge; docked one point for minor repetition such as 'You are the orchestrator' restated within three lines and routing rules re-stated across the intro and Step 0. | 4 / 5 |
Actionability | Copy-paste-ready commands throughout (e.g. 'npx hyperframes init ... --skill=product-launch-video', 'node <SKILL_DIR>/scripts/build-frame.mjs --preset <name> --hyperframes .') with exact file paths, exit-code contracts, and parameterized placeholders covering the common cases. | 5 / 5 |
Workflow Clarity | Steps 0-6 are explicitly sequenced, each ending in a bolded '**Gate:**' validation checkpoint, with feedback loops ('If a command fails, surface stderr and stop... fix it yourself, then rerun') and collaborative-vs-autonomous branches plus lint/check/snapshot verification before render. | 5 / 5 |
Progressive Disclosure | The orchestrator body points one-level-deep to real, clearly signaled reference files (references/story-design.md, visual-design.md, motion-language.md, cut-catalog.md all exist) and a Quick Reference table maps each read to its step, with design/motion/story detail appropriately split out of the overview. | 5 / 5 |
Total | 19 / 20 Passed |