Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a tight, well-organized instruction-only skill that assumes Claude's competence and provides a clear authoring workflow with a QA checkpoint. Its main gap is actionability: it tells Claude how to write guidelines but never shows a concrete worked example of an authored component guideline.
Suggestions
Add one short worked example of an authored component rule (e.g., a Button rule with anatomy, states, and token usage) so the guidance is copy-paste ready.
Show a concrete 'must'/'should' rule paired with its don't-example, as the 'Example Constraint Language' section prescribes but does not demonstrate.
Include a minimal sample QA checklist with checkable items rather than only naming the checklist as a deliverable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and bulleted with no padding or explanation of concepts Claude already knows (e.g., what design systems or accessibility are); every section adds task-specific guidance, matching 'lean and efficient; every token earns its place'. | 3 / 3 |
Actionability | Guidance is concrete in places ('required states: default, hover, focus-visible, active, disabled, loading, error', token list, 8pt grid) but it describes how to author guidelines rather than showing a copy-paste example of an authored guideline, fitting 'some concrete guidance but incomplete'. | 2 / 3 |
Workflow Clarity | The 6-step 'Guideline Authoring Workflow' is clearly sequenced and ends with an executable QA checklist ('QA checklist that can be executed in code review'), satisfying the checklist requirement of the top anchor for this non-destructive authoring task. | 3 / 3 |
Progressive Disclosure | No bundle files exist and the single-file body is well-organized into clearly labeled sections (Mission, Style Foundations, Accessibility, Workflow, Quality Gates), which per the simple-skills note merits a 3 without external references. | 3 / 3 |
Total | 11 / 12 Passed |