mobile-ios-design

Master iOS Human Interface Guidelines and SwiftUI patterns for building native iOS apps. Use when designing iOS interfaces, implementing SwiftUI views, or ensuring apps follow Apple's design principles.

1.36x

Quality

76%

Does it follow best practices?

Impact

89%

1.36x

Average score across 6 eval scenarios

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/ui-design/skills/mobile-ios-design/SKILL.md

Quality

Content

65%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable with excellent executable Swift examples, but it underuses the provided reference bundle and inlines content that belongs in those files, weakening progressive disclosure. Tightening concept explanations and linking the reference files would lift the weaker dimensions.

Suggestions

Link the existing reference files from the relevant body sections (e.g., 'See [swiftui-components.md](references/swiftui-components.md)') and move the bulk of the inlined component/navigation/HIG detail there, keeping SKILL.md a concise overview.

Trim explanations of concepts Claude already knows (e.g., the HIG Clarity/Deference/Depth glosses) to lean one-line reminders, letting the code carry the teaching.

Add a short sequenced workflow with checkpoints for a representative iOS build task (e.g., pick layout → implement → verify Dynamic Type/Dark Mode/VoiceOver) so the reference material has an explicit process to follow.

Dimension	Reasoning	Score
Conciseness	Mostly efficient with useful code examples, but HIG-principle explanations Claude already knows and inlined content that duplicates the reference files could be tightened; not padded enough for a 2, not lean enough for a 4.	3 / 5
Actionability	Abundant copy-paste-ready, executable Swift covering the common cases (VStack/HStack, LazyVGrid, NavigationStack, TabView, SF Symbols, Dynamic Type, materials, a full FeatureCard component), matching the fully executable anchor.	5 / 5
Workflow Clarity	This is broad reference material, not a sequenced process; topical sections are organized but there is no multi-step workflow with validation checkpoints, so it sits at the 'steps/structure present but checkpoints missing' level.	3 / 5
Progressive Disclosure	Good section structure exists, but the three reference files (hig-patterns.md, ios-navigation.md, swiftui-components.md) are never signaled or linked while parallel content is inlined in the body, matching 'references present but not clearly signaled; content that should be separate is inline'.	3 / 5
	Total	14 / 20 Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, well-targeted description that clearly states both capability and trigger conditions in third person with concrete phrasing. Only minor gains are available from adding a few more natural synonyms.

Dimension	Reasoning	Score
Specificity	Lists several specific actions ('designing iOS interfaces, implementing SwiftUI views, ensuring apps follow Apple's design principles') with only minor coverage gaps, falling short of the fully comprehensive anchor 5.	4 / 5
Completeness	Explicitly answers both 'what' ('Master iOS Human Interface Guidelines and SwiftUI patterns for building native iOS apps') and 'when' ('Use when designing iOS interfaces, implementing SwiftUI views, or ensuring apps follow Apple's design principles') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Good natural keyword coverage ('iOS interfaces', 'SwiftUI views', 'Apple's design principles', HIG implied) that users would say, though a few natural synonyms like 'iPhone/iPad app' are missing, so not a 5.	4 / 5
Distinctiveness Conflict Risk	Occupies a clear iOS/SwiftUI/Apple-HIG niche with distinct triggers and minimal overlap risk with other skills.	5 / 5
	Total	18 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: wshobson/agents
Path: plugins/ui-design/skills/mobile-ios-design/SKILL.md
Commit: 367cb6a

Reviewed: about 7 hours ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

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.