Content
80%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 well-organized, highly actionable body that uses progressive disclosure effectively with verified reference files. The main gap is the absence of explicit validation/preview checkpoints in the install and wiring workflows, which matters because install supports batch operations.
Suggestions
Add a verify/preview step to the install and block-wiring workflows (e.g., open the host composition or run a preview command after wiring) so batch and write operations have an explicit checkpoint.
Tighten the rationale prose in the Discovery and 'Report what the catalog does not have' sections to just the actionable rule, removing the justifying follow-on sentences.
Show how to confirm a batch 'hyperframes add <tag>' result (e.g., inspect the printed file list or run 'hyperframes catalog --type block --tag <tag>') before wiring, since batch installs write multiple files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with executable bash/HTML/JSON blocks and no beginner-concept padding, but several rationale passages ('This is the whole demand signal for the catalog. Skipping it means the gap you hit gets guessed at from install counts instead…') could be trimmed without losing the instruction. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands and markup throughout — 'hyperframes add data-chart', 'npx hyperframes catalog --query "reveal a headline one line at a time"', a complete block-wiring HTML example, and a JSON config block — covering the common install/wiring/discovery cases. | 5 / 5 |
Workflow Clarity | Sequences are clearly laid out (5-step component wiring, search→install→report-gap discovery), but install — including the batch 'hyperframes add captions' that installs every tagged block — has no explicit validation or preview checkpoint, so the batch-operation cap holds this at 3. | 3 / 5 |
Progressive Disclosure | Clear overview in SKILL.md with well-signaled, one-level-deep references to real files ('See [install-locations.md](./references/install-locations.md) for full details', plus wiring-blocks, wiring-components, discovery, contributing, templates), with detail appropriately split out and easy to navigate. | 5 / 5 |
Total | 17 / 20 Passed |