Content
71%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 dense, highly actionable rulebook with explicit build sequencing, specific behavioral constraints, and honest testing and reporting requirements. Its main weaknesses are the total absence of code examples or templates to anchor the abstract rules, and a monolithic single-file structure that ignores progressive disclosure.
Suggestions
Move the ~40-line gesture/camera section into a references/ file (e.g. references/gestures.md), keeping a short summary plus a pointer in SKILL.md; the storage-format rules are a similar candidate.
Add one or two concrete examples — a sample registry entry and a minimal saved-layout document — so the abstract rules have a copy-paste-ready anchor.
Consolidate the repeated teardown and theme rules, which currently appear in multiple sections, into single statements to tighten the token budget.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, directive, and free of concept explanations Claude already knows — e.g. "Combine pointer and wheel updates into at most one transform write per animation frame". However, rules repeat across sections (teardown duties appear three times in the gesture section; theme guidance recurs in three sections), so a trim pass would earn anchor 5. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is unusually concrete: exact CSS ("overscroll-behavior-x: none", "cursor: default"), specific gestures ("Ctrl/Meta + wheel and trackpad pinch", "Space + primary-button drag"), and a label example ("Pricing card · compact"). Not 5 because there is no code snippet or template at all (e.g., a sample registry entry or storage document shape); not 3 because the directives are specific and executable, not pseudocode. | 4 / 5 |
Workflow Clarity | Sequencing is explicit — "Start with one safe live preview... Add the registry and requested content next. Then add copying, camera controls, existing themes, and saved layout" — and the final section supplies checkpoints ("Make sure that the route mounts, imports resolve, and the console shows no errors. Inspect the diff for unintended production changes"). Not 5 because there is no explicit fix-and-retry loop when checks fail, and testing requirements are spread across paragraphs rather than gathered into a checklist. | 4 / 5 |
Progressive Disclosure | Seven clearly headed sections give good structure, but the skill is a single ~160-line monolith with no bundle files at all; the 40+ line gesture section and the storage-format rules clearly belong in separate reference files. Matches anchor 3 ("content that should be separate is inline"); not 2 because headers and organization are good, and not 4-5 because progressive disclosure into reference files is entirely unused on a skill far above the 50-line simple-skill threshold. | 3 / 5 |
Total | 15 / 20 Passed |