Content
72%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 well-structured overview for an advisory skill: dense, platform-specific control principles, a complete and verified 14-file reference index with easy navigation, and a defined output format. The weaknesses are an implicit rather than explicit workflow sequence and small amounts of filler (duplicated description line, vacuous "When to Use" section, branding footer).
Suggestions
Add an explicit numbered workflow and order sections to follow it, e.g.: 1. Check .claude/apple-design-context.md 2. Ask any unresolved "Questions to Ask" 3. Select the control using Key Principles and the reference files 4. Produce the answer in "Output Format".
Delete the filler "When to Use" section ("This skill is applicable to execute the workflow or actions described in the overview.") and the duplicated first line to recover tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 11 Key Principles are dense, substantive one-liners ("Toggles for binary states. On or off.", "2-5 items, roughly equal importance, short labels") with platform-specific facts Claude cannot be assumed to know. Minor trimmable waste keeps this at anchor 4 rather than 5: the body's first line duplicates the frontmatter description verbatim, the trailing "When to Use" section is pure filler ("This skill is applicable to execute the workflow or actions described in the overview."), and the branding footer adds tokens without guidance value. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is concrete and executable: "In Settings-style screens, changes take effect immediately. In modal forms, changes commit on confirmation", "Configure keyboard type to match expected input (email, URL, number)", "Display current value next to the stepper with reasonable min/max bounds", plus a four-part Output Format defining the deliverable. It falls short of anchor 5 only because there is no worked example of the recommended output and the validation guidance stays high-level. | 4 / 5 |
Workflow Clarity | All workflow components exist (context check "before asking questions", a "Questions to Ask" intake list, decision principles with references, and an "Output Format"), but they are never sequenced into an explicit process — the document even places "Questions to Ask" after "Output Format", so the actual order (check context → ask → decide → produce output) must be inferred. This matches anchor 3 ("sequence present but checkpoints missing or implicit") rather than anchor 4's explicitly numbered steps. | 3 / 5 |
Progressive Disclosure | The body is a genuine overview that keeps details in the bundle: the Reference Index table lists all 14 references with topic and key-content columns, every referenced path (controls.md, toggles.md, segmented-controls.md, sliders.md, steppers.md, pickers.md, combo-boxes.md, text-fields.md, text-views.md, labels.md, token-fields.md, virtual-keyboards.md, rating-indicators.md, gauges.md) was verified to exist in references/, and they are one level deep. This closely matches the anchor-5 pattern of a lean overview with well-signaled one-level-deep references. | 5 / 5 |
Total | 16 / 20 Passed |