Content
90%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.
A strong, dense body: executable commands and code for every common case, clean section-to-reference mapping, and no padding. The only weaknesses are the absence of an explicit post-wiring validation step and the orphaned demo-html-pattern.md reference file.
Suggestions
Add a brief validation checkpoint after the wiring sections (e.g. how to preview/confirm the wired block or component renders in the host composition) to close the workflow gap.
Reference demo-html-pattern.md from the body (most naturally from the 'Wiring components' or 'Contributing' sections) so the bundled guidance is discoverable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence: no explanation of what HTML, GSAP, or registries are; every section delivers commands, code, or a tightly-scoped note (e.g. 'hyperframes add only works for blocks and components. For examples, use hyperframes init'). Each of the ~100 lines earns its place; not score 4 because there is no identifiable over-explanation to trim. | 5 / 5 |
Actionability | Fully executable guidance throughout: copy-paste bash commands with flags ('hyperframes add data-chart --json', '--no-clipboard'), a complete JSON config block, a complete HTML wiring snippet, and a concrete numbered 5-step procedure for component merging. The common cases (install a block, install a component, wire each) are each covered with specific examples; not score 4 because nothing requires the reader to fill in missing details. | 5 / 5 |
Workflow Clarity | Sequences are clear — install (CLI prints which files were written, plus the snippet to paste) then wire blocks (attribute table) or components (numbered steps), and wiring includes the correctness constraint 'must match the block's internal composition ID'. However, no explicit validation/verify step exists after wiring or installing (no 'preview/confirm the composition renders' checkpoint), matching the anchor for clear sequence with minor validation gaps rather than the anchor-5 explicit validation steps and feedback loops. | 4 / 5 |
Progressive Disclosure | The body is a well-structured overview with clearly signaled one-level-deep references to real files (install-locations.md, wiring-blocks.md, wiring-components.md, discovery.md, contributing.md, templates.md), each placed exactly at its topic. However, the bundle file references/demo-html-pattern.md is never referenced from SKILL.md or any other reference file — an orphaned resource that is hard to discover — which is a minor organization gap matching anchor 4 rather than the fully navigable anchor 5. | 4 / 5 |
Total | 18 / 20 Passed |