Content
75%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 well-structured routing skill: lean overview, clear workflow with precedence and branching, and a comprehensive routing table to one-level-deep references. The main gaps are two dangling referenced paths (palettes/, frame-presets/) and verification being referenced rather than an inline workflow checkpoint.
Suggestions
Resolve or remove the dangling references: the routing/workflow cite `palettes/*.md` and `frame-presets/`, but neither directory exists in the bundle — either add them or point to where they actually live (e.g., a sibling skill).
Promote design-adherence verification into the Workflow as an explicit final checkpoint (e.g., step 5: verify colors/type/corners/spacing via references/design-adherence.md) so the validation loop is part of the sequence rather than only a routing row.
Tighten the scripts section: the `HYPERFRAMES_SKILL_PKG_VERSION` pinning sentence can be shortened, and the emphatic blockquote's repetition can be trimmed without losing the 'read these first' signal.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean — a routing table, short workflow, and boundaries with no concept over-explanation — but the emphatic blockquote ("Skipping these is the single biggest cause of generic, web-page-looking output. They are not optional...") and the HYPERFRAMES_SKILL_PKG_VERSION version-pinning prose are slightly more than fully lean, fitting the 4 anchor. | 4 / 5 |
Actionability | As an instruction/routing skill it gives concrete, specific guidance — exact reference paths per topic and one executable command (`python skills/hyperframes-creative/scripts/extract-audio-data.py <audio-file>`) — with only minor gaps since most design steps are delegated to references rather than shown inline, matching the 4 anchor. | 4 / 5 |
Workflow Clarity | The numbered Workflow has explicit precedence (frame.md → design.md → DESIGN.md) and conditional branches for spec-present vs. absent and multi-scene vs. motion-heavy work, but verification lives in the routing table (design-adherence.md) rather than as an inline checkpoint, so it sits at 4 rather than 5. | 4 / 5 |
Progressive Disclosure | Clear overview with a topic→file routing table and one-level-deep references (all 15 cited reference files and all 3 scripts exist), but two routes point to paths absent from the bundle — `palettes/*.md` and `frame-presets/` — which is a minor navigation gap keeping it below 5. | 4 / 5 |
Total | 16 / 20 Passed |