Content
63%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 a well-organized pattern library with strong, mostly executable code examples and good decision guidance, but it re-states its rules across three sections and keeps every example inlined rather than progressively disclosing detail via reference files. Trimming the duplication and splitting a few pattern examples into references would tighten it considerably.
Suggestions
Remove or merge the Principles section (it restates Rules 1–4 verbatim) and trim 'When to Activate', which duplicates the frontmatter description.
Move the less-common pattern examples (shared-element crossfade, accordion, scroll progress) into a references/ file linked from a short index, keeping only the top patterns inline in SKILL.md.
Complete the fragmentary examples — give the button pattern a full component and add the missing 'use client' directive and imports to the accordion example.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly dense and assumes competence (no library tutorials), but the same eight rules are stated three times — the Principles section restates Rules 1–4, and the Anti-Patterns table re-covers all eight — while "When to Activate" duplicates the frontmatter description. | 3 / 5 |
Actionability | Most patterns ship complete, executable TSX (stagger, modal, toast, page transition, scroll reveal, expanding card), but the button and shared-element snippets are fragments and the accordion example omits its "use client" directive and imports, so coverage is not fully copy-paste ready. | 4 / 5 |
Workflow Clarity | There is no multi-step process to sequence, but the decision tables ("Choosing the right pattern", wait/sync/popLayout) and the explicit "Must be set up first" dependency on motion-foundations give unambiguous guidance for selecting and composing patterns. | 4 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ all absent), so ~250 lines of code examples are inlined in a 435-line SKILL.md; section headers are clear, but the per-pattern examples are content that could be split into one-level-deep reference files. | 3 / 5 |
Total | 14 / 20 Passed |