CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

swiftui-patterns

Structure and refactor SwiftUI views using Observation, clear state ownership, composition, and deterministic previews. Use for view architecture and data flow; route detailed layout, navigation, animation, performance, and visual effects to their dedicated skills.

Quality

94%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

An exemplary skill body: lean, assumes competence, and highly actionable through a property-wrapper decision table and concrete rules. The only meaningful gap is that the workflow's validation checkpoints lack an explicit fix-and-retry feedback loop. Progressive disclosure is a model case, with the overview holding only decision-level guidance and all detail in well-signaled, flat reference files.

DimensionReasoningScore

Conciseness

The ~125-line body is dense with project-specific guidance (ownership table, extraction signals, iOS 27 preflight) and never explains concepts Claude already knows, e.g. no 'SwiftUI is Apple's framework' padding. Version-sensitive details ('Xcode 27', 'iOS 27') are correctly confined to a preflight section that delegates to references/ios27-updates.md rather than inlined.

5 / 5

Actionability

For an instruction-only skill the guidance is copy-paste-level concrete: a decision table mapping each wrapper ('@State', '@Bindable', '@Binding', '@Environment(Type.self)', '@Query') to exact use-when conditions, five explicit extraction signals, and a precise '.task or .task(id:)' vs stored 'Task' rule. Per the rubric's code-vs-instruction note, the absence of code is not penalized because every rule tells Claude exactly what to do.

5 / 5

Workflow Clarity

The 5-step Workflow has an explicit validation checkpoint ('Build after a meaningful extraction or risky change, then render useful previews and exercise affected interactions') plus an 11-item Review Checklist. It falls short of the top anchor only because there is no explicit error-recovery feedback loop (what to do when the build fails or behavior differs); step 5's 'restore any changed behavior' gestures at it but the loop is not spelled out.

4 / 5

Progressive Disclosure

The body is a concise overview with all detail pushed to 10 real, verified, one-level-deep reference files, surfaced both inline with context signals ('Read [Isolated Preview Construction]... when a preview needs fixtures') and in an annotated References section. Verified against the actual bundle: all referenced paths exist (69-701 lines each) and no reference nests another reference (the sole cross-link in ios27-updates.md routes to sibling skills, which is boundary routing, not nesting).

5 / 5

Total

19

/

20

Passed

Description

92%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 with explicit what/when structure, specific capability enumeration, and exemplary sibling-skill routing that minimizes conflict risk. The only improvement area is trigger-term breadth: adding natural synonyms like 'state management' or 'bindings' would close the gap to comprehensive keyword coverage.

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities — 'Structure and refactor SwiftUI views using Observation, clear state ownership, composition, and deterministic previews' — comprehensively covering the skill's scope rather than naming a domain with generic actions. Not 4: there are no coverage gaps; the capability list plus the routing clause fully enumerates what the skill does.

5 / 5

Completeness

It explicitly answers both questions: what ('Structure and refactor SwiftUI views using Observation, clear state ownership, composition, and deterministic previews') and when ('Use for view architecture and data flow') with concrete trigger phrases. Not 4: the when-clause is explicit and names specific trigger domains rather than being vague or implied.

5 / 5

Trigger Term Quality

Good natural-keyword coverage ('SwiftUI views', 'refactor', 'previews', 'view architecture', 'data flow', plus routing terms 'layout', 'navigation', 'animation', 'performance'), but common user phrasings like 'state management', 'bindings', or 'property wrappers' are absent and 'Observation' is framework jargon users would less often say. Not 5 because synonym coverage is incomplete; not 3 because the terms present are natural and well-chosen, not merely 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche (view structure, state ownership, data flow) and actively reduces conflict by routing 'detailed layout, navigation, animation, performance, and visual effects to their dedicated skills'. This explicit negative boundary makes mistaken triggering on sibling skills minimal.

5 / 5

Total

19

/

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

thienqo/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.