Content
78%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.
The body is an exceptionally dense, actionable style spec with strong validation via the pre-flight checklist, and it wastes no tokens. Its main defects are a missing example.html file referenced as the code anchor and the absence of an explicit ordered build workflow.
Suggestions
Ship the referenced example.html (or remove the 'See example.html in this directory' line) — as written, the skill's only code reference is a dead path.
Add a short ordered build sequence (e.g. scaffold from example.html → apply required archetypes → verify against the pre-flight checklist) to convert the spec into a workflow.
Consider moving the ten slide archetypes to a references file with one minimal HTML snippet each, keeping SKILL.md as the overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean spec — hex codes, clamp() sizes, spacing values, a banned list, ten archetypes, and a pre-flight checklist — with no padding and no explanation of concepts Claude already knows. Every token earns its place, matching the 'lean and efficient' anchor. | 5 / 5 |
Actionability | Guidance is highly concrete with copy-paste-ready values ('#FBFBFA', 'clamp(56px, 6.5vw, 96px)', 'letter-spacing: 0.18em', 'cubic-bezier(0.16, 1, 0.3, 1)') and ten specific slide archetypes. It stops short of 5 because the referenced executable example ('See example.html in this directory') does not exist in the bundle, leaving no complete starter code. | 4 / 5 |
Workflow Clarity | The spec is well-ordered (substrate/type rules → banned → archetypes → motion → pre-flight checklist) and the pre-flight checklist provides explicit validation checkpoints. It is not 5 because there is no explicit build sequence (e.g. start from example.html, apply archetypes, then run pre-flight) tying the pieces into an ordered procedure. | 4 / 5 |
Progressive Disclosure | The body is short and well-sectioned, which would suit a 5 under the simple-skill note, but its single external reference — 'See example.html in this directory' — is broken: no example.html (or references/scripts/assets bundle) exists. A dangling reference with no other navigation structure matches the 'references present but' defective-organization anchor rather than a good-structure one. | 3 / 5 |
Total | 16 / 20 Passed |