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 high-quality patterns skill: nearly every line is project-specific hard-won guidance with named precedents, concrete decision tables, copy-ready status strings, and a pre-ship validation checklist, and it respects the reader's intelligence. The residual gaps are structural rather than substantive — an implicit rather than explicit step sequence, an external unverifiable mock as the only concrete layout example, and research detail that could be offloaded to a reference file.
Suggestions
Add a short numbered procedure up top (pick shape from table → draft status text per rules → check anti-patterns → run the ship checklist) so the sequence is explicit rather than implied by section order.
Move the per-app precedent survey (Spotlight/Photos/iCloud/Alfred bullets) into a references/ file and keep one summary line plus the split rule inline, freeing body tokens.
Inline one small mock snippet (a pane with label + caption + Rebuild button) so the concrete layout example does not depend solely on the external components/specs/settings.html file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and project-specific throughout — the decision table, status-string rules, anti-pattern list, and worked example are all signal this project had to learn the hard way, and it assumes competence (never explains what a checkbox or Form is). The Apple HIG blockquotes ("Minimize the number of settings you offer...") are cited precedent load-bearing to the rules, not padding. It sits at 4 rather than 5 because minor trimming is possible: the Spotlight/Photos/iCloud/Alfred bullet list partly repeats the table row above it, and the four-item worked example runs long. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is unusually concrete: a seven-row problem→shape→precedent table, copy-ready status strings ("Can't reach your cloud board right now. Events are being kept and will be sent when it's back."), a named precedent for every rule, and a pre-ship checklist. Not 5 because some guidance stays abstract ("ask where the state changes a decision, and put it there") and the one concrete layout artifact is delegated to an external file ("components/specs/settings.html") with no inline example. | 4 / 5 |
Workflow Clarity | There is a clear implicit sequence — the one rule, then shape selection, then status text, then structure, then anti-patterns as a check — and an explicit validation checkpoint: the "Before you ship a settings change" checklist. No destructive or batch operations are involved, so the workflow cap does not apply. Held at 4 rather than 5 because the procedure is never laid out as an explicit ordered workflow (the reader assembles it from section order), and the only error-recovery model is implicit in the worked example's four wrong answers. | 4 / 5 |
Progressive Disclosure | This is a single-file skill with no bundle (no references/, scripts/, or assets/ exist), and the body is well-sectioned rather than a monolithic wall. The "Where the evidence lives" section gives one-level-deep, per-file pointers with a clear 'start here' (synthesis.md) and a description of each file's most reusable content — good navigation. Not 5: the detailed six-agent research is summarized inline across several sections (shape precedents, status text rules) that could sit in a reference file, and the pointed-to paths live outside the skill bundle, so the reference structure cannot be verified. | 4 / 5 |
Total | 16 / 20 Passed |