Content
77%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 unusually actionable review methodology — literal scripts, fill-in templates, checkable criteria, and a well-sequenced pass structure with re-rating feedback loops. Its weaknesses are token efficiency (a sizable chunk restates standard usability theory Claude already knows) and progressive disclosure (reference-grade checklists are inlined rather than split into bundle files).
Suggestions
Move the AI-slop blacklist, landing/app/universal rules, and usability heuristics into references/ files (e.g. references/slop-checklist.md, references/usability.md) and keep SKILL.md as the pass structure plus templates, which would cut the body roughly in half.
Trim or remove 'How users actually behave' and the 'Three laws of usability' sections — Claude already knows Krug and Nielsen; keep only the few rules that are load-bearing for rating decisions, stated in one line each.
Replace the name-drop reference list (Rams, Norman, Nielsen, Gestalt, Krug, Redish, Jarrett) with a single pointer to a references file, since the bare citations add tokens without actionable content.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The pass structure, templates, and slop blacklist are dense and specific, but roughly 40+ lines ('How users actually behave', 'Three laws of usability', 'The trunk test', 'The goodwill reservoir') restate well-known Krug/Nielsen usability principles Claude already knows, which is more than the 'minor instances' of the 4 anchor. It is above 2 because the majority of the body is applied, task-specific guidance rather than padding. | 3 / 5 |
Actionability | For an instruction-only skill the guidance is fully executable: a literal rating script ('Information Architecture: 4/10' → gap → fix → re-rate), fill-in table templates for states, journey storyboard, and deferred decisions, plus checkable hard-rejection criteria and yes/no litmus checks. This matches the 5 anchor's 'copy-paste ready' standard applied to instructions; nothing stays at the vague-direction level of 4. | 5 / 5 |
Workflow Clarity | The sequence is explicit (Step 0 scope → Passes 1–7 → Output table) with a built-in feedback loop (rate, state the gap, fix, re-rate until 10 or 'good enough'), re-run rules (8+ gets a quick pass), and approval checkpoints ('get approval before editing the plan', one gap per question). This matches the 5 anchor's explicit validation and feedback loops; 4's 'minor validation gaps' does not apply since re-rating is enforced after every fix. | 5 / 5 |
Progressive Disclosure | Sections are well-organized with headers and templates, but ~150 lines of reference-grade material (the AI-slop blacklist, landing/app/universal rules, and usability heuristics) are inlined in a ~280-line SKILL.md with no bundle files at all. This fits the 3 anchor (content that should be separate is inline); not 2, since structure and navigation are genuinely good, and not 4, because the bulk detail belongs in references/ files for a skill this long. | 3 / 5 |
Total | 16 / 20 Passed |