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 router/index skill that assumes Claude's competence and points clearly to detailed materials via a routing table and executable audit script. The main gaps are a missing inline composition code example and several referenced .md files absent from the provided bundle.
Suggestions
Add a minimal inline GSAP paused-timeline snippet to the 'Default: compose atomic rules' section so the primary path is copy-paste executable without first loading rules-index.md.
Either include the referenced rules/blueprints/adapters .md files in the bundle or note that they live in a sibling HyperFrames skill package, so signaled references are actually navigable.
Tighten a few explanatory sentences (e.g. the 'faster and produces less code' justification and the runtime-coexistence note) to reduce token cost.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Generally lean and assumes competence (no explanation of what GSAP/Lottie are), but a few sentences could be trimmed, e.g. 'This is faster and produces less code than starting from a blueprint.' and 'Multiple runtimes can coexist... so HyperFrames can seek all of them in one pass.' | 4 / 5 |
Actionability | Provides a copy-paste-ready audit command ('node skills/hyperframes-animation/scripts/animation-map.mjs <composition-dir> --out ...') and a precise routing table, but the default compose path ('glue them together with a single paused GSAP timeline') lacks an inline executable code example. | 4 / 5 |
Workflow Clarity | Clear default-then-optional sequence (compose rules → load blueprint → pick runtime → audit via animation-map) with the audit script acting as a validation checkpoint after authoring, though no explicit validate→fix→retry loop is spelled out for the authoring path. | 4 / 5 |
Progressive Disclosure | Exemplary overview structure with a routing table of one-level-deep references, and the referenced scripts (animation-map.mjs, package-loader) exist in the bundle; however many referenced .md paths (rules-index.md, blueprints/, adapters/*.md) are not present in the bundle, so not every signaled reference is navigable here. | 4 / 5 |
Total | 16 / 20 Passed |