CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

swiftui-expert-skill

Write, review, or improve SwiftUI code following best practices for state management, view composition, performance, and iOS 26+ Liquid Glass adoption. Use when building new SwiftUI features, refactoring existing views, reviewing code quality, or adopting modern SwiftUI patterns.

88

1.20x
Quality

82%

Does it follow best practices?

Impact

95%

1.20x

Average score across 6 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

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

Well-structured skill content with excellent progressive disclosure (14 real, clearly signaled, one-level references) and highly actionable, version-aware guidance. The main cost is token efficiency: most rules are restated across the workflow tree, core guidelines, and review checklist, which roughly doubles the body's necessary length.

Suggestions

Collapse the three-fold repetition: replace the Review Checklist's per-item restatements with references to the Core Guidelines sections (e.g., 'State Management: see checklist items under Core Guidelines'), keeping the checklist as a short list of section pointers rather than a third copy of every rule.

Drop duplicate Quick Reference content: the Property Wrapper Selection table repeats the Core Guidelines 'State Management' rules verbatim — keep only the table (or only the prose) in one location.

Tighten the Workflow Decision Tree by replacing full guidance sentences with just the reference pointer (e.g., '- Check state wrappers (see references/state-management.md)') since the details already live in Core Guidelines and the references.

DimensionReasoningScore

Conciseness

Rule statements are dense and imperative with no basic-concept padding, but nearly every guideline appears three times across the Workflow Decision Tree, Core Guidelines, and Review Checklist (e.g., "@State properties are private" / "@State must be private"; "Button used instead of onTapGesture" in workflow, core, and checklist). Fits anchor 3 'mostly efficient but could be tightened'; not 2 because nothing explains concepts Claude already knows, and the repetition is at least partially purposeful (checklists for review mode).

3 / 5

Actionability

Concrete, executable guidance throughout: a property-wrapper selection table, specific modifiers (".animation(_:value:)", "glassEffectID with @Namespace"), a working #available fallback snippet, and "Self._logChanges()" for debugging. Not 5 because the Liquid Glass examples use placeholder views (GlassButton1(), GlassButton2()) and most guidance is rules rather than copy-paste-ready code; not 3 because the guidance is specific and directly executable, not pseudocode.

4 / 5

Workflow Clarity

Three clearly sequenced workflows (review / improve / implement) each with an explicit prioritized first step ("First, consult references/latest-apis.md") and a supporting review checklist. Not 5 because there are no explicit validation checkpoints or error-recovery loops (e.g., what to do when a deprecated API has no modern equivalent); not 3 because the sequence is complete and checkpoints are present via the checklist, and the destructive/batch cap does not apply since these are code authoring/review tasks.

4 / 5

Progressive Disclosure

SKILL.md is a genuine overview: all detail lives in 14 one-level-deep reference files that all exist in the bundle, each clearly signaled inline ("see references/state-management.md") with one-line descriptions in a dedicated References section, plus a required-reading marker for latest-apis.md. Matches the score-5 anchor (clear overview, well-signaled one-level references, easy navigation); not 4 because no organization gaps were found — every reference path resolves to a real file.

5 / 5

Total

16

/

20

Passed

Description

83%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/imperative voice, concrete capability areas, and an explicit 'Use when' clause with four natural trigger phrases. The only weaknesses are minor — a few missing capability areas (accessibility, navigation) and some natural synonym variations.

DimensionReasoningScore

Specificity

Lists several concrete actions ("Write, review, or improve SwiftUI code") and four specific focus areas ("state management, view composition, performance, and iOS 26+ Liquid Glass adoption"). Not 5 because coverage has gaps (accessibility, navigation, lists not mentioned); not 3 because it goes well beyond 1-2 actions and names multiple concrete capability areas.

4 / 5

Completeness

Explicitly answers both: what ("Write, review, or improve SwiftUI code following best practices for state management, view composition, performance, and iOS 26+ Liquid Glass adoption") and when ("Use when building new SwiftUI features, refactoring existing views, reviewing code quality, or adopting modern SwiftUI patterns") with concrete trigger phrases. Matches the score-5 anchor; score 4's 'when could be more explicit' does not apply since the when clause lists four specific triggers.

5 / 5

Trigger Term Quality

Good natural-phrase coverage: "building new SwiftUI features", "refactoring existing views", "reviewing code quality", "adopting modern SwiftUI patterns" — phrases users would plausibly say. Not 5 because some common variations are missing (e.g., ".swift", "Swift UI", "iOS app UI", "UIKit migration"); not 3 because the terms present are natural user phrasings, not jargon.

4 / 5

Distinctiveness Conflict Risk

Clear niche (SwiftUI, iOS 26+ Liquid Glass) with distinct triggers; unlikely to fire for non-SwiftUI work. Overlap risk with a generic Swift skill is minor, which matches the score-4 anchor better than 5 only if a sibling Swift skill existed; the description's tight SwiftUI scoping and explicit triggers give minimal conflict risk, but 'SwiftUI code' review/improve could overlap with a general code-review skill, so 4 is the safer best fit per anti-drift.

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

SnowingFox/macos-island

Path

.cursor/skills/swiftui-expert-skill/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.