Content
88%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 lean, highly actionable conventions document: exact attributes, percentages, commands, sequenced workflows, and an explicit validation section with a fix loop and expected timeline shape. Its one real defect is a vestigial 'Plugin installs' paragraph that references nonexistent 'setup or freshness commands' and 'update instructions below'.
Suggestions
Remove or repair the opening 'Plugin installs' paragraph: neither 'setup or freshness commands' nor 'the update instructions below' exist in this body, so it wastes tokens and misdirects navigation (affects conciseness and progressive_disclosure).
Move the plugin-install note (if kept) below the '# HyperFrames Studio conventions' heading or into its own labeled section so the document opens with its title.
In 'Checking your work', make the re-validation loop explicit (e.g., 'run hyperframes check again until it reports no findings before opening Studio') so the feedback loop is written, not inferred.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and prescriptive throughout, assuming Claude's competence (no explanations of what timelines, captions, or video editing are), but the opening 'Plugin installs' paragraph is wasted tokens: it refers to 'setup or freshness commands' and 'the update instructions below', neither of which exists in this file. | 4 / 5 |
Actionability | Guidance is fully executable for an instruction-only skill: exact attributes ('data-composition-src', 'data-track-kind="captions"', per-kind 'data-track-index'), a kind-to-attribute table, concrete safe-box percentages (90%/5%, 80%/10%) traced to named source constants, and the copy-paste command 'Run hyperframes check'. Not 4 — there are no missing key details; the verification target is enumerated to the row ('a base row, one row per scene host, one caption row and the audio rows'). | 5 / 5 |
Workflow Clarity | Sequences are clear and tabular (message-triage table in § 0, the five-step Brief→Notes build-order table in § 5), and validation is explicit with a fix loop and checklist: 'Run hyperframes check (it runs lint) and fix every finding. Then open the project in Studio and check that the timeline shows a base row, one row per scene host, one caption row and the audio rows.' Protective checkpoints ('never overwrite locked frames', 'never overwrite BRIEF.md or STORYBOARD.md') are embedded in the steps themselves. | 5 / 5 |
Progressive Disclosure | References are one level deep and clearly signaled with full skill paths ('/hyperframes-core references/creator-editing-recipes.md', '/hyperframes references/pitch-round.md', '/hyperframes-creative references/storyboard-recipe.md'), and content is appropriately split ('Each step has an owner; follow it and do not restate it here'). Not 5 because the pre-heading 'Plugin installs' paragraph dangles — its 'update instructions below' target does not exist in this file — a minor navigation gap. | 4 / 5 |
Total | 18 / 20 Passed |