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.
A well-structured overview skill: lean principle summaries, an excellent one-level-deep reference table pointing at real files, and specific actionable rules with a defined output format. Its main weaknesses are an implicit rather than explicit workflow sequence and a pointless boilerplate 'When to Use' section at the end.
Suggestions
Add an explicit numbered workflow, e.g.: 1. Check .claude/apple-design-context.md for existing context; 2. Ask the listed questions to fill gaps; 3. Consult the relevant reference(s) from the index; 4. Produce output in the defined format.
Delete the boilerplate 'When to Use' section ('This skill is applicable to execute the workflow or actions described in the overview.') — it is generic filler that adds no information.
Add one worked example of a full recommendation (scenario → chosen component → rationale → sample alert/sheet text) to make the output format concrete.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient: ten principles each stated in 1–2 sentences with no padding and no explanation of concepts Claude already knows; detail is correctly deferred to references. Minor trimming targets keep it from anchor 5 — the boilerplate closing section 'This skill is applicable to execute the workflow or actions described in the overview' earns nothing, and the attribution footer plus 'Related Skills' cross-listing add tokens with marginal value. | 4 / 5 |
Actionability | The guidance is concrete and executable for an instruction-only skill: 'Button labels should be specific verbs ("Delete", "Save"), not "OK"', 'Destructive button style (red text)', 'On action sheets, cancel appears at the bottom, separated', plus a defined four-part output format and a question checklist. It is not anchor 5 because there is no worked example of a complete recommendation (e.g., a sample scenario mapped to a chosen component and alert text), leaving minor gaps in covering common cases. | 4 / 5 |
Workflow Clarity | A workflow exists in pieces — 'Check for .claude/apple-design-context.md before asking questions', 'Questions to Ask', 'Reference Index', 'Output Format' — but it is never sequenced into an explicit ordered process (ask first or consult references first?), and there are no validation checkpoints (e.g., verifying a recommendation against the relevant reference before answering). This matches anchor 3: sequence present but implicit, checkpoints missing. No destructive/batch cap applies since the skill is advisory. | 3 / 5 |
Progressive Disclosure | The body is a lean overview with a well-signaled reference index table ('[alerts.md](references/alerts.md)' etc.) giving topic and key content for each of five references; all five files exist, are one level deep, and contain no nested references. This matches anchor 5: clear overview, well-signaled one-level-deep references, content appropriately split, easy navigation. | 5 / 5 |
Total | 16 / 20 Passed |