Content
71%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured design guidance skill with strong progressive disclosure and good conciseness. Its main weakness is actionability — it provides principles and references but lacks concrete examples of recommended outputs or specific implementation patterns (e.g., showing what a good component recommendation looks like). The reference index is a standout feature that makes navigation easy.
Suggestions
Add a concrete example in the Output Format section showing what a complete response looks like (e.g., a sample recommendation for a macOS menu bar app with component choice, hierarchy, and platform notes).
Include at least one specific SwiftUI or UIKit code snippet illustrating a recommended button or menu pattern to improve actionability.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is mostly efficient and well-structured. The key principles are concise and informative without over-explaining. Minor verbosity in the 'When to Use' section and the promotional footer, but overall respects Claude's intelligence. The 'Questions to Ask' section is lean and useful. | 4 / 5 |
Actionability | The skill provides design guidance principles and a clear reference index, but lacks concrete, executable examples. There are no code snippets, SwiftUI/UIKit examples, or specific implementation patterns. The output format section describes what to produce but doesn't show an example of a good response. For a design guidance skill (instruction-only), the principles are reasonably specific but could benefit from concrete examples of correct vs incorrect menu/button usage. | 3 / 5 |
Workflow Clarity | The skill has a clear implicit workflow: check context file → consult principles → reference detailed docs → produce output in specified format → ask clarifying questions if needed. The output format section provides a clear 4-point structure. However, there's no explicit sequencing of steps or validation checkpoints. As a non-destructive, advisory skill, this is acceptable but could be slightly more explicit about the decision process. | 4 / 5 |
Progressive Disclosure | Excellent progressive disclosure structure. The SKILL.md provides a concise overview of 10 key principles, then a well-organized reference table pointing to 11 specific reference files with clear topic descriptions. References are one level deep, clearly signaled with a table format, and the content is appropriately split between overview and detailed reference material. However, no bundle files were provided to verify the references actually exist. | 5 / 5 |
Total | 16 / 20 Passed |