This skill should be used when the user asks to "create a SwiftUI view", "build an iOS app", "set up an Xcode project", "review Apple platform code", "add a widget", "create a watchOS app", "build for visionOS", "fix SwiftUI layout", or when generating any Swift code targeting Apple platforms (iOS, iPadOS, macOS, tvOS, watchOS, visionOS). Provides modern SwiftUI-first best practices covering UI patterns, app lifecycle, navigation, project structure, and platform-specific guidance. Use together with `swift-development` for Swift language fundamentals. Always generates Swift unless the project explicitly requires Objective-C.
70
86%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description that excels across all dimensions. It provides extensive natural trigger terms quoted directly as user phrases, clearly delineates what the skill covers (SwiftUI-first best practices, UI patterns, navigation, etc.) and when to use it, and explicitly distinguishes itself from the related `swift-development` skill for language fundamentals. The description is comprehensive without being padded.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions and domains: SwiftUI views, iOS apps, Xcode projects, Apple platform code review, widgets, watchOS apps, visionOS builds, SwiftUI layout fixes. Also specifies coverage areas like UI patterns, app lifecycle, navigation, project structure, and platform-specific guidance. | 3 / 3 |
Completeness | Clearly answers both 'what' (provides modern SwiftUI-first best practices covering UI patterns, app lifecycle, navigation, project structure, platform-specific guidance) and 'when' (explicit trigger phrases and scenarios listed at the beginning). The 'Use when' equivalent is the opening sentence with quoted trigger phrases. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would say: 'create a SwiftUI view', 'build an iOS app', 'set up an Xcode project', 'review Apple platform code', 'add a widget', 'create a watchOS app', 'build for visionOS', 'fix SwiftUI layout'. Also lists platform names (iOS, iPadOS, macOS, tvOS, watchOS, visionOS) which are highly natural keywords. | 3 / 3 |
Distinctiveness Conflict Risk | Clearly scoped to Apple platform development with SwiftUI focus, distinct from general Swift language fundamentals (explicitly delineated via the reference to `swift-development` for language fundamentals). The specific platform names and SwiftUI focus create a clear niche unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong, well-organized skill that provides actionable SwiftUI/Apple platform guidance with excellent progressive disclosure through a comprehensive reference file structure. Its main weaknesses are moderate verbosity (particularly the TCA and theming sections could be tighter) and the lack of explicit step-by-step workflows with validation checkpoints for multi-step operations like project setup or feature implementation. The code examples are high quality and immediately usable.
Suggestions
Trim the TCA section to a brief mention with a reference link rather than a full inline code example — it's an alternative pattern that could live in a reference file.
Add an explicit step-by-step workflow for common multi-step tasks (e.g., 'Creating a new feature module') with validation checkpoints like building, running previews, and testing.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is generally well-structured but includes some unnecessary verbosity — the TCA section is quite long for an alternative pattern, the design token section is extensive with two full code examples, and some explanations (like 'This is the natural pattern for SwiftUI with @Observable') add little value. However, it mostly avoids explaining concepts Claude already knows and delegates fundamentals to the swift-development skill. | 2 / 3 |
Actionability | The skill provides fully executable Swift code examples throughout — Observable model + view pattern, MVVM with state management, TCA reducer, environment-based DI, design tokens. All code is copy-paste ready with realistic patterns, not pseudocode. The naming conventions table and common mistakes table provide concrete, specific guidance. | 3 / 3 |
Workflow Clarity | The skill provides clear architectural patterns and rules but lacks explicit multi-step workflows with validation checkpoints. For example, there's no step-by-step process for 'setting up an Xcode project' or 'adding a widget' with verification steps. The MVVM pattern shows a clear structure but doesn't include a workflow for building/validating/testing a feature end-to-end. For a skill covering project setup and multi-step operations, explicit validation steps would strengthen this. | 2 / 3 |
Progressive Disclosure | Excellent progressive disclosure with a comprehensive reference file listing covering 16+ reference files, each clearly described with key topics. The main SKILL.md provides essential patterns inline while delegating platform-specific details, advanced patterns, and interop guides to well-organized reference files. Navigation is clear with tables mapping platforms/features to references. References are one level deep and well-signaled. | 3 / 3 |
Total | 10 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
70de68f
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.