Content
81%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 a well-sequenced, gated 7-step workflow with strong actionability and explicit validation checkpoints — a model of workflow clarity. Conciseness is good but has a few trim opportunities, and one reference link in the Quick Reference table points to a non-existent local file.
Suggestions
Fix or remove the 'references/techniques.md' row in the Reference Files table — that file does not exist in the bundle; either add it or point the row to the actual location (e.g. the cross-skill ../hyperframes path).
Tighten the duplicated routing guidance: the frontmatter description and the opening blockquote both restate the NOT-for routing; consolidate to one authoritative routing pointer to save tokens.
Trim the autonomous-mode guardrail paragraph ('Autonomous mode is NOT skip all gates') — its core rule could be one sentence pointing into step-2-brief.md, reducing body length without losing the gate taxonomy.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and directive with almost no pedagogy of concepts Claude already knows, but a few passages (the autonomous-mode guardrail paragraph and the repeated routing warning at the top) could be tightened; efficient but not maximally lean. | 4 / 5 |
Actionability | Provides concrete executable commands ('npx hyperframes auth status', 'npx hyperframes lint', 'npx hyperframes validate') and a precise snapshot formula, with per-step gates and named artifacts; minor gaps where detail is deferred to reference files rather than stated inline. | 4 / 5 |
Workflow Clarity | Seven explicitly sequenced steps each carry an artifact + explicit Gate checkpoint, with validation feedback loops (lint/validate zero errors, per-beat HTML read, DoD checklist, honest-disclosure section) matching the anchor for clear sequence with explicit validation. | 5 / 5 |
Progressive Disclosure | Clear overview with one-level-deep per-step 'Read: references/step-N.md' signals and a Reference Files table; all 8 step/capability refs resolve. Capped below 5 because the Reference Files table lists 'references/techniques.md' (not present in the bundle) and two '../hyperframes/references/*.md' paths that are not verifiable here, an organization gap. | 4 / 5 |
Total | 17 / 20 Passed |