CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

swiftui-patterns

Builds and reviews SwiftUI views with modern MV architecture, state, composition, isolated previews, and migration guidance. Covers @Observable ownership, @State/@Bindable/@Environment wiring, view decomposition, ViewModifiers, environment values, .task loading, iOS 26+ handoffs, Writing Tools, clipboard availability, and performance. Use when structuring SwiftUI state, managing @Observable, composing views, previewing meaningful UI states, or correcting SwiftUI patterns.

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is dpearson2699/swift-ios-skills

SKILL.md
Quality
Evals
Security

Quality

Content

92%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.

Excellent body content: lean expert-level guidance, fully executable code examples covering the common cases, a workflow with explicit validation and feedback loops, and clean one-level-deep progressive disclosure to six real reference files. Only marginal trimming opportunities keep conciseness at 4 rather than 5.

DimensionReasoningScore

Conciseness

The body is dense and assumes expertise — no padding explaining what SwiftUI or Observation is, and rules are stated crisply ('Always use .task — it cancels automatically on view disappear'). Minor instances could be trimmed (the Contents list duplicates section headers, and the four-view ownership example is slightly long), fitting the level-4 'efficient; minor instances that could be trimmed' anchor rather than level 5.

4 / 5

Actionability

Fully executable, copy-paste-ready Swift throughout: a complete FeedView with ViewState enum and .task/.refreshable wiring, the ItemStore ownership trio (@State/@Bindable/@Environment), @Entry environment values, CardStyle ViewModifier, and concrete decision tables (wrapper selection, Writing Tools levels). Specific examples cover the common cases — the level-5 anchor.

5 / 5

Workflow Clarity

The 5-step Workflow has an explicit validation checkpoint ('Build after each structural step; fix compiler and isolation errors before continuing') and a feedback loop ('If behavior changes, restore the fixture, fix the smallest boundary, and rerun the same build, preview, and interaction checks'), reinforced by a 20-item Review Checklist — matching the level-5 anchor with explicit validation, error-recovery loops, and a checklist.

5 / 5

Progressive Disclosure

A clear overview with a table of contents, a scope-boundary paragraph, and six one-level-deep reference files (architecture-patterns, deprecated-migration, design-polish, platform-and-sharing, preview-isolation, view-refactoring) — all verified to exist, each clearly signaled contextually ('Load … for fixture and dependency patterns') and again in a dedicated References section with per-file descriptions — the level-5 anchor.

5 / 5

Total

19

/

20

Passed

Description

88%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: third-person voice, dense with concrete capabilities, and an explicit 'Use when…' clause with natural trigger phrases. The only weaknesses are a few missing natural keyword variations and unstated boundaries against the sibling SwiftUI skills.

Suggestions

Add a boundary clause distinguishing this skill from its siblings, e.g., 'For navigation, layout components, animation, or Liquid Glass, see the dedicated swiftui-* skills.'

Include one or two more natural trigger variations users might say, such as 'view models', 'MVVM', or 'Swift UI state'.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions — 'Builds and reviews SwiftUI views with modern MV architecture', '@Observable ownership, @State/@Bindable/@Environment wiring, view decomposition, ViewModifiers, environment values, .task loading' — with comprehensive capability coverage and no gaps, matching the level-5 anchor rather than the level-4 'minor gaps' anchor.

5 / 5

Completeness

Explicitly answers both 'what' (two sentences of concrete capabilities: building/reviewing views, MV architecture, state wiring, previews, migration guidance) and 'when' ('Use when structuring SwiftUI state, managing @Observable, composing views, previewing meaningful UI states, or correcting SwiftUI patterns') with concrete trigger phrases — the level-5 anchor.

5 / 5

Trigger Term Quality

Natural phrases like 'SwiftUI views', 'structuring SwiftUI state', 'managing @Observable', 'composing views', 'previewing meaningful UI states' are terms users would actually say, but a few natural variations are missing (e.g., 'view models', 'MVVM', plain 'Swift'), fitting the level-4 'good keyword coverage; a few natural terms missing' anchor rather than comprehensive level 5.

4 / 5

Distinctiveness Conflict Risk

The SwiftUI architecture/state/composition niche is clear, but sibling skills named in the body (swiftui-navigation, swiftui-layout-components, swiftui-animation, swiftui-liquid-glass) cover adjacent SwiftUI territory and the description does not flag those exclusions, so there is minor overlap risk with closely related skills — level 4 rather than level 5's 'minimal conflict risk'.

4 / 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

dpearson2699/swift-ios-skills

Path

skills/swiftui-patterns/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.