Content
68%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 advisory skill for Apple HIG layout and navigation guidance. Its strengths are the comprehensive reference index, the navigation pattern selection table, and the layout adaptation checklist. Its main weaknesses are the lack of executable code examples (SwiftUI/UIKit snippets would significantly improve actionability) and the absence of a clearly sequenced workflow with validation steps.
Suggestions
Add concrete SwiftUI code snippets for the most common navigation patterns (e.g., NavigationSplitView with sidebar, TabView with .sidebarAdaptable) to improve actionability.
Define an explicit numbered workflow sequence: e.g., 1) Check context file, 2) Ask clarifying questions, 3) Select navigation pattern, 4) Verify against checklist, 5) Output recommendation — to improve workflow clarity.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is mostly efficient and well-structured. The key principles section has some statements that are somewhat obvious to Claude (e.g., 'Users should always know where they are'), and the trailing marketing line and 'When to Use' section add no value. But overall, the tables and checklists are dense and informative. | 4 / 5 |
Actionability | The navigation pattern selection table provides concrete, specific guidance mapping app structures to recommended patterns with platform adaptations. The layout adaptation checklist and output format are actionable. However, there are no executable code examples (e.g., SwiftUI NavigationSplitView snippets), which would elevate this for a design/development skill. | 4 / 5 |
Workflow Clarity | The skill describes a consultative workflow (ask questions, recommend pattern, specify hierarchy, describe adaptation) via the output format and questions sections, but there's no explicit sequencing of steps, no validation checkpoints, and no feedback loop for verifying recommendations against requirements. For a non-destructive advisory skill this is acceptable but still lacks clear step ordering. | 3 / 5 |
Progressive Disclosure | The reference index table with 12 clearly labeled reference files is well-organized and provides one-level-deep navigation. The related skills section adds useful cross-references. However, since no bundle files were provided, we cannot verify the referenced paths exist, and the skill could benefit from slightly clearer signaling about when to consult each reference (some of this is implicit from the table's 'Key content' column). | 4 / 5 |
Total | 15 / 20 Passed |