Content
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is concise, actionable, and uses progressive disclosure effectively with a routing table and verified one-level-deep references. Its weakest dimension is workflow clarity, which lists steps but does not elevate design-adherence verification into an explicit checkpoint in the workflow sequence.
Suggestions
Wire post-authoring verification into the workflow: add a step like '5. Verify authored spec against design rules → references/design-adherence.md' so verification is an explicit checkpoint rather than only a routing-table row.
Reconcile the routing table with the bundle: 'frame-presets/' and 'palettes/*.md' are referenced but not present in the skill folder — either add these paths or remove the rows to keep navigation trustworthy.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence: it does not explain what a video, palette, or beat is, and every line earns its place (e.g. the precedence rule 'frame.md → design.md → DESIGN.md' and frontmatter parsing convention are stated once compactly). Not a 2 because there is no padded explanatory filler. | 3 / 3 |
Actionability | Provides a concrete copy-pasteable command ('python skills/hyperframes-creative/scripts/extract-audio-data.py <audio-file>'), explicit file paths, and a routing table mapping each topic to a specific reference file. Not a 2 because guidance is executable and specific rather than pseudocode or abstract. | 3 / 3 |
Workflow Clarity | The 4-step workflow is clearly sequenced with precedence rules, but it lacks an explicit validation checkpoint: the post-authoring verification reference (design-adherence.md) appears only in the routing table, not wired into the workflow as a 'verify before finishing' step. Not a 3 because no feedback-loop/checkpoint is stated; not a 1 because the sequence itself is clear. | 2 / 3 |
Progressive Disclosure | SKILL.md is an overview pointing to one-level-deep references via a well-organized routing table, with two must-read-first files clearly signaled; all 14 referenced reference files and 3 scripts exist in the bundle. Not a 2 because content is appropriately split and easily navigable rather than a monolithic wall. | 3 / 3 |
Total | 11 / 12 Passed |