Content
67%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, highly actionable skill body with concrete code, a worked example, and explicit validation feedback loops. Its main weakness is verbosity in the prose-heavy porting and media-cleanup sections, which could be trimmed for token efficiency.
Suggestions
Tighten the 'Porting source pages' and media-cleanup/nav-mute prose into terser bullet rules; several multi-sentence explanations can be cut to one line without losing the contract.
Consider condensing the long single bullets in 'Porting source pages' (e.g. the scroll/camera-motion and media-crop bullets) into shorter rules with the rationale moved to standalone-harness.md.
Optional: present the end-to-end authoring flow as one short numbered checklist near the top so the sectioned detail reads as reference rather than the primary workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Most content is genuinely HyperFrames-specific contract detail Claude would not know, but several prose sections (porting source pages, media cleanup, nav mute) are noticeably verbose and could be tightened without losing clarity. | 3 / 5 |
Actionability | Provides a fully executable worked example with real HTML/JSON/CSS/GSAP and specific commands (npx hyperframes lint/check/present), with only minor gaps in the prose-heavy porting guidance. | 4 / 5 |
Workflow Clarity | The authoring steps are sectioned clearly and validation has an explicit feedback loop (run lint and check, fix, rerun until 0 errors), with only minor sequencing gaps since the workflow is spread across sections rather than one numbered sequence. | 4 / 5 |
Progressive Disclosure | SKILL.md acts as an overview with a clearly signaled one-level reference to references/standalone-harness.md (a real file), and most detail is appropriately placed with minor organization gaps in the large inline contract sections. | 4 / 5 |
Total | 15 / 20 Passed |