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.
An excellent overview body: token-efficient, fully actionable commands with output contracts and explicit auth/billing feedback loops, and a clear routing table to real reference files. The only deductions are a scattered (rather than consolidated) workflow sequence and minor bundle-organization gaps - a second-level reference chain and two unlinked reference files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and operational throughout ("renders never fetch", "No signal, no suggestion; respect 'leave it'", "--plan is for you"), adding only project-specific policy Claude could not know, with zero padding or explanation of known concepts. Not 4: there are no sections that could be trimmed without losing load-bearing guidance. | 5 / 5 |
Actionability | The core verb is copy-paste ready with an output contract ("npx hyperframes media-use resolve --type <type> --intent …"; "prints one line, resolved <id> → <path>"), the table supplies concrete --type values (bgm, sfx, logo, voice, video, cutout), and exact commands (auth status, tts, transcribe, remove-background, media-treatment) plus a credit-limit JSON snippet cover the common cases. Not 4: no missing key details for the primary flow. | 5 / 5 |
Workflow Clarity | Checkpoints and feedback loops are present (auth status before paid calls, wait until the person confirms sign-in; a refused call names a billing command - say why, ask them to run it, then retry; --candidates before generating), fitting the clear-sequence-with-most-checkpoints anchor. It is not 5 because the steps are distributed across sections rather than consolidated into one explicit ordered flow, and not 3 because validation for the risky paths (auth, billing) is explicit. | 4 / 5 |
Progressive Disclosure | Scored against the actual bundle: the "Where to look" table cleanly routes 10 tasks to 10 real reference files, but media-treatments.md points onward to media-treatment-recipes.md (a 2-level chain), meta.md and telemetry-dashboard.md are never linked from the body, and the 14-file scripts/ bundle is only surfaced indirectly through references. This fits good-structure-with-minor-organization-gaps rather than the clean one-level-deep anchor. | 4 / 5 |
Total | 18 / 20 Passed |