Content
77%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 tightly written, highly actionable dispatch-entry skill with an excellent sequenced workflow, explicit validation gates, repair feedback loops, and a resume table. Its chief weakness is progressive disclosure: the body signals many reference files that are absent from the provided bundle, so most navigated paths do not resolve.
Suggestions
Ship the referenced bundle files (agents/director.md, agents/builder.md, agents/finalize.md, phases/source/guide.md, catalog-map.md, categories/<id>/module.md, references/preview-render.md, references/intent-interview.md) alongside SKILL.md so the signaled navigation actually resolves.
If some paths are intentionally external to this skill (e.g. under SKILL_DIR or ../hyperframes-core), mark them as such (e.g. '<SKILL_DIR>/agents/director.md') so a reader knows they live outside the local bundle rather than appearing missing.
Replace the '<proof-times>' placeholder with a concrete default example (e.g. '--at 0,1.5,end') so the verify step is copy-paste ready.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense and information-rich, assuming Claude's competence (it delegates detail to subagent docs rather than re-explaining); minor trimmable content in the category tables and the maintainer-only 'Design notes' section, which is appropriately flagged as not read during execution. | 4 / 5 |
Actionability | Provides concrete, mostly copy-paste-ready bash ('npx hyperframes init ... --skill=motion-graphics', 'npx hyperframes lint .', 'npx hyperframes render ... -o ./renders/video.mp4') and explicit subagent dispatch prompts; minor gaps like the '<proof-times>' placeholder and the 'illustrative — see phases/source/guide.md' source command keep it just below fully executable. | 4 / 5 |
Workflow Clarity | A clear sequenced flow (Step 0 init → plan → source → design → build → verify → approve → render) with explicit validation gates ('lint', 'check', 'snapshot'), a repair feedback loop ('dispatch the repair subagent ... then rerun the failed gate'), and a resume table mapping state to the correct re-entry point. | 5 / 5 |
Progressive Disclosure | The body is well-structured as a dispatch entry with clearly signaled one-level-deep references (agents/director.md, phases/source/guide.md, categories/<id>/module.md, references/*), but most referenced paths do not exist in the shipped bundle — only references/builder-contract.md, references/motion-vocabulary.md, and references/shot-plan-ir.md are present — so navigation largely leads to missing files. | 3 / 5 |
Total | 16 / 20 Passed |