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.
The body is an exemplary lean composition README: copy-paste-ready install, mount, and render commands, a precise variables table, and a runtime contract with non-obvious constraints (seek-safety, closed-form animation, no Date.now). The only improvement space is a slightly tighter distinction between runtime assets and user-editable surfaces in the file manifest.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section carries project-specific, non-obvious information — the approved-timing overview, the file manifest with sizes, the install/mount/render commands, the variables table, and three non-generic editing rules — with no tutorial filler or explanation of concepts Claude already knows. "Lean and efficient; every token earns its place." | 5 / 5 |
Actionability | Guidance is fully executable: "npx hyperframes add orbit-card", a complete copy-paste mount <div> with all data-* attributes, a render command with a concrete --variables JSON payload, and a variables table giving types, defaults, and the -36000–36000 range for cardOrbitDegrees. The common install/mount/customize cases are all covered. | 5 / 5 |
Workflow Clarity | The install → mount → render sequence is linear and unambiguous with concrete commands at each step, and the variables section explains runtime access precisely. As a single-purpose, non-destructive skill, the simple-skill exception applies: the one action (install and mount the composition) is unambiguous with no risky operations requiring validation checkpoints. | 5 / 5 |
Progressive Disclosure | Well-organized sections (Files, Install, Variables, Runtime contract, Editing rules) with a manifest that matches the actual assets/ bundle file-for-file. Docked one point because the body runs ~68 lines (above the under-50-lines guideline for an unqualified 5) and the large runtime assets (orbit-motion.js 59 KB, orbit-scene.js 8 KB) are listed only by size, with no one-line note distinguishing hands-off runtime files from the files a user would actually edit — a minor organization gap per the anchor "most content is appropriately placed... minor organization gaps". | 4 / 5 |
Total | 19 / 20 Passed |