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 tight, opinionated, project-specific design skill that assumes competence, gives concrete decision rules with named precedents, and closes with a shipping checklist that acts as its validation loop. It is self-contained with no bundle files, so progressive disclosure is organized but cannot reach the exemplary split-file form.
Suggestions
Consider extracting the per-app precedent evidence (Spotlight/Photos/iCloud/Alfred) into a reference file so the core SKILL.md stays even leaner while preserving the detail.
Add an explicit validation feedback loop near the worked example (e.g., 'after moving progress to the surface, re-check: does Settings still show any state it cannot change?') to push workflow_clarity toward 5.
Verify the cited integration/remote-hub/scratch/*.md paths exist, or move that evidence into a bundled reference, so the 'Where the evidence lives' pointers resolve from the skill itself.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and assumes competence (no explanations of what a checkbox or iOS is); every section is load-bearing and the Apple/Mullvad/Spotlight evidence is genuinely non-obvious project knowledge. Minor re-explanation in the worked example keeps it just below the lean 5 anchor. | 4 / 5 |
Actionability | Concrete, executable design rules with named precedents ('Six toolbar tabs maximum. General first.', 'Grouped Form sections with a footer per section', 'a checkbox plus an expensive action such as Rebuild'); absence of code is appropriate for this instruction skill and guidance is specific, sitting just below the fully copy-paste-ready 5. | 4 / 5 |
Workflow Clarity | The 'Before you ship a settings change' checklist provides explicit validation checkpoints (label alone carry it? counts in user's units? pane lets you change everything it shows? updated settings.html?), giving a clear sequence with most checkpoints present, just short of the full error-recovery feedback-loop 5. | 4 / 5 |
Progressive Disclosure | Self-contained body with well-organized sections and one-level-deep, clearly signaled pointers ('Where the evidence lives' -> synthesis.md and research-*.md); no bundle files exist to split, so structure is good with minor gaps rather than the exemplary multi-file split of the 5 anchor. | 4 / 5 |
Total | 16 / 20 Passed |