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, lean index skill that routes effectively to real one-level references and gives a clear sequenced workflow. The main gaps are two unresolved bundle paths (frame-presets/, palettes/) and verification being referenced rather than inlined as a workflow checkpoint.
Suggestions
Resolve or qualify the 'frame-presets/' and 'palettes/*.md' routing-table entries — either add the directories to the bundle or note they are sibling/runtime locations so navigation does not dead-end.
Fold the post-authoring verification step (design-adherence.md) into the Workflow as an explicit final checkpoint, e.g. '5. Verify spec adherence via references/design-adherence.md before delivering', to add a concrete validation loop.
Tighten the motivational blockquote to a single directive sentence so every remaining token earns its place.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean overview/router with no padding of concepts Claude already knows, but the motivational blockquote ('Skipping these is the single biggest cause of generic, web-page-looking output', 'They are not optional rows in the routing table below') is mildly editorial and could be trimmed, keeping it just below the score-5 lean anchor. | 4 / 5 |
Actionability | Provides a copy-paste command ('python skills/hyperframes-creative/scripts/extract-audio-data.py <audio-file>'), an env var pin (HYPERFRAMES_SKILL_PKG_VERSION), and concrete file-precedence ('frame.md → design.md → DESIGN.md'), but most guidance is 'read this reference' routing rather than direct executable steps, leaving minor gaps versus the fully copy-paste-ready score-5 anchor. | 4 / 5 |
Workflow Clarity | A clear 4-step sequenced workflow with an explicit decision branch in step 2 and cross-skill handoffs; verification exists only as a separate routing-table row ('Post-authoring spec verification → references/design-adherence.md') rather than an inline checkpoint, so it falls short of the explicit validate/feedback-loop score-5 anchor. | 4 / 5 |
Progressive Disclosure | Exemplary one-level-deep structure — an overview, a topic→file routing table, a 'Read these two FIRST' priority signal, and all references/scripts verified to exist — but the routing table also points at 'frame-presets/' and 'palettes/*.md' which are not present in the bundle, a minor navigation gap that holds it below score 5. | 4 / 5 |
Total | 16 / 20 Passed |