CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

84

1.36x
Quality

79%

Does it follow best practices?

Impact

89%

1.36x

Average score across 6 eval scenarios

SecuritybySnyk

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
SKILL.md
Quality
Evals
Security

Quality

Content

60%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 a well-organized, code-first reference with genuinely executable SwiftUI examples, though parts re-teach fundamentals Claude already knows. Its biggest structural flaw is that the three bundled reference files are never mentioned, so duplicated detail stays in SKILL.md and the deeper material is undiscoverable.

Suggestions

Add a clearly signaled references section in SKILL.md (e.g., 'Navigation patterns: See [ios-navigation.md](references/ios-navigation.md)') for each of the three bundled files, and trim the body sections that duplicate their content.

Move the foundational SwiftUI layout explanations (VStack/HStack/LazyVGrid basics) into references/swiftui-components.md, keeping only HIG-specific guidance and one compact quick-start example in SKILL.md.

Add a short design workflow with a validation checkpoint, such as: choose navigation pattern -> apply semantic colors/typography -> verify with Dynamic Type, Dark Mode, and VoiceOver previews before finalizing.

DimensionReasoningScore

Conciseness

The body is code-heavy and free of prose padding, but much of it explains SwiftUI fundamentals Claude already knows (basic VStack/HStack alignment, standard TabView setup, semantic fonts). It could be tightened to focus on HIG-specific values and conventions. Not 2 because there is no multi-paragraph conceptual filler or library-comparison padding.

3 / 5

Actionability

Complete, compilable SwiftUI snippets throughout (NavigationStack with NavigationPath, Tab API, symbol effects, materials, and a fully self-contained Quick Start FeatureCard). Not 5 because several examples depend on undefined symbols (items, ItemCard(item), volume, notificationCount), which are minor gaps.

4 / 5

Workflow Clarity

Well organized for a reference-style skill: a 'When to Use This Skill' section, a Quick Start component, Best Practices, and Common Issues give a usable orientation. Not 5 because there is no design/build sequence and no validation checkpoint (e.g., how to verify a layout against HIG or preview it), which leaves the working process implicit.

4 / 5

Progressive Disclosure

The bundle contains three reference files (references/hig-patterns.md, references/ios-navigation.md, references/swiftui-components.md), but the body contains zero pointers to any of them while inlining duplicate material (the Navigation Patterns section overlaps ios-navigation.md). Scored against the actual bundle structure, the references are invisible rather than merely weakly signaled. Not 3 because that anchor requires references to be 'present but not clearly signaled', whereas here no navigation exists at all and content that already lives in separate files is duplicated inline.

2 / 5

Total

13

/

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 description that clearly states what the skill does and gives an explicit 'Use when...' clause with multiple concrete triggers. The only weaknesses are the generic lead verb 'Master' and missing common synonyms (iPhone, iPad, UIKit).

DimensionReasoningScore

Specificity

Concrete actions are present ('designing iOS interfaces', 'implementing SwiftUI views', 'building native iOS apps') but the lead phrase 'Master iOS Human Interface Guidelines and SwiftUI patterns' is a generic pattern rather than a concrete action, leaving minor gaps in coverage. Not 5 because 'Master X' is padding and the action list is not comprehensive of the domain.

4 / 5

Completeness

Explicitly answers both: the 'what' ('Master iOS Human Interface Guidelines and SwiftUI patterns for building native iOS apps') and the 'when' ('Use when designing iOS interfaces, implementing SwiftUI views, or ensuring apps follow Apple's design principles') with three concrete trigger phrases. Clearly matches the anchor-5 example shape.

5 / 5

Trigger Term Quality

Good natural keyword coverage: 'iOS', 'SwiftUI', 'Apple's design principles', 'native iOS apps' are terms users would actually say. Not 5 because common synonyms like 'iPhone', 'iPad', 'HIG', 'UIKit', or 'Xcode' are missing.

4 / 5

Distinctiveness Conflict Risk

A clear Apple-platform niche with distinct triggers (SwiftUI, HIG, Apple's design principles); minimal conflict risk since these terms would not naturally fire a non-Apple design skill. Not 4 because no specific overlapping sibling skill's territory is plausibly claimed.

5 / 5

Total

18

/

20

Passed

Validation

100%

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

Reviewed

Table of Contents

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.