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 highly actionable CLI reference: executable commands throughout, a clear ordered workflow with validation checkpoints (lint/inspect before render, strict modes, doctor-first troubleshooting), and lean tool-specific prose. The only structural note is that everything lives in SKILL.md with no split reference material, and a couple of passages could be tightened.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely lean and tool-specific — command blocks with inline comments, a compact flags table, and no explanation of concepts Claude already knows. It sits at the 4 anchor ('efficient; minor instances of over-explanation that could be trimmed') because a few passages repeat themselves slightly (e.g., the Studio-URL guidance across lines 76-88 restates the index.html-is-not-the-project point), rather than the 5 anchor where every token earns its place. | 4 / 5 |
Actionability | Every section is copy-paste-ready executable commands with real flags, defaults, and concrete variants ('npx hyperframes inspect --at 1.5,4,7.25', 'transcribe subtitles.srt', 'tts "Text here" --voice af_nova'), plus a complete flags table for render. This matches the 5 anchor (fully executable, common cases covered) and exceeds 4 ('minor gaps') — the common cases for each subcommand are all shown. | 5 / 5 |
Workflow Clarity | The workflow is an explicit numbered sequence (Scaffold → Write → Lint → Inspect → Preview → Render) with the ordering rule 'Lint and inspect before preview', and validation is built in: 'Errors should be fixed before rendering', '--strict'/'--strict-all' to fail on errors/warnings, and 'Run doctor first if rendering fails' for error recovery. This matches the 5 anchor (clear sequence, explicit validation, error-recovery guidance); the 4 anchor's 'minor validation gaps' does not apply since validation checkpoints are stated at each stage. | 5 / 5 |
Progressive Disclosure | The single file is well-sectioned per command with no nested or buried references, and the one pointer out ('see the hyperframes skill') is clearly signaled, matching the 4 anchor ('good structure; most content appropriately placed; minor organization gaps'). It does not reach 5 because there is no reference file layer at all — content such as the full render flag table and template/command catalog is inlined, which is acceptable at this size but leaves the overview carrying everything. | 4 / 5 |
Total | 18 / 20 Passed |