CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

swiftui-view-refactor

Refactor SwiftUI view files into stable, testable structure. Use when splitting large views, tightening data flow, or cleaning Observation ownership.

62

Quality

78%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/build-ios-apps/skills/swiftui-view-refactor/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-structured, highly actionable skill with concrete prefer/avoid examples and a clear workflow. Weaknesses are repeated guidance that could be consolidated into the reference file and a workflow lacking any post-refactor verification step.

Suggestions

Add an explicit verification step to the Workflow (e.g., 'build the target and compare view behavior/previews before finishing') so behavior preservation is checked rather than only stated as a constraint.

Consolidate the subview-extraction guidance repeated in section 3, Workflow step 3, Notes, and Large-view handling into one section, moving extended rationale to references/mv-patterns.md.

Link references/mv-patterns.md from section 2 (Default to MV, not MVVM) where its guidance is most relevant, instead of only mentioning it once in Notes.

DimensionReasoningScore

Conciseness

The body is rule-driven without concept padding, but the core "prefer dedicated subview types over computed some View helpers" guidance is repeated across section 3, Workflow step 3, the Notes section, and Large-view handling. Mostly efficient but with duplicated guidance that could be consolidated; more than the minor trimming of anchor 4.

3 / 5

Actionability

Concrete prefer/avoid Swift examples, an explicit top-to-bottom property ordering list, exact property wrappers (@State, @Environment, @Query, @Binding, @StateObject), and a copy-paste init pattern for view models cover the common refactor cases specifically. The undefined helper types (FilterChip, searchService) are standard illustration conventions, not gaps in the guidance.

5 / 5

Workflow Clarity

The 7-step Workflow is clearly sequenced, but no validation checkpoint exists: nothing tells Claude to build, run previews, or verify behavior after refactoring (step 7 is a constraint, not a check). Sequence present with checkpoints missing matches anchor 3; not 4 because no explicit verification step is present.

3 / 5

Progressive Disclosure

Sections are well organized and references/mv-patterns.md is a real, one-level-deep, clearly named reference. Not 5 because the reference is signaled only once in Notes rather than from section 2 whose MV guidance it elaborates, and body section 2 overlaps the reference's content rather than splitting it cleanly.

4 / 5

Total

15

/

20

Passed

Description

78%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 concisely states both the capability and explicit use-when triggers in a distinctive niche. The main gaps are slightly thin action coverage and missing common trigger synonyms like view model or MVVM.

DimensionReasoningScore

Specificity

"Refactor SwiftUI view files into stable, testable structure" names the domain and one concrete action with outcome qualities, but does not list several distinct capabilities (subview extraction, view model handling, Observation migration are only implicit). Not 4 because the capability coverage rests on a single action verb plus adjectives rather than several specific actions.

3 / 5

Completeness

"Refactor SwiftUI view files into stable, testable structure" explicitly answers what it does, and "Use when splitting large views, tightening data flow, or cleaning Observation ownership" explicitly answers when with concrete trigger phrases. This matches the top anchor: both what and when are explicit and specific.

5 / 5

Trigger Term Quality

Triggers like "splitting large views", "tightening data flow", and "cleaning Observation ownership" are natural phrases users would say in a SwiftUI refactor request. Not 5 because common synonyms such as "view model", "MVVM", or "extract subviews" are absent; not 3 because multiple relevant natural terms are present.

4 / 5

Distinctiveness Conflict Risk

The SwiftUI view refactoring niche is clear with distinctive triggers (large views, data flow, Observation ownership), but a general code-refactoring or Swift-review skill could plausibly trigger on the same requests. Mostly distinct with minor overlap risk with closely related skills.

4 / 5

Total

16

/

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

openai/plugins

Path

plugins/build-ios-apps/skills/swiftui-view-refactor/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.