CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

swift-architecture

Selects, reviews, and migrates Apple-platform app architectures across MV with Observation, MVVM, MVI, TCA, Clean Architecture, Coordinator, and legacy VIPER. Use when choosing module and dependency boundaries, escalating a feature beyond simple SwiftUI MV, planning incremental architecture migration, or auditing state ownership and test seams.

Quality

95%

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.

A well-structured, actionable skill body: executable code, a validated decision workflow, and a clean one-level reference split. The only improvement opportunity is merging the overlapping Pattern Selection and Escalation Signals criteria.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — tables, one executable Swift example, a checklist, and no explanation of known concepts. However, the Pattern Selection table's "Choose when" column and the Escalation Signals bullets substantially restate the same per-pattern criteria (e.g., "Presentation logic needs an independently testable adapter" vs. "substantial presentation transformation must be tested without rendering"), which is duplication that could be trimmed. This sits between the efficient and every-token-earns-its-place anchors, noticeably above the midpoint.

4 / 5

Actionability

The MV Default section provides copy-paste-ready @Observable TripStore/TripList Swift code, the pattern table gives concrete selection criteria, migration steps are numbered and specific, and the Common Mistakes table pairs each mistake with a fix. Specific examples cover the common cases, matching the fully-executable anchor.

5 / 5

Workflow Clarity

The Decision Workflow ends with an explicit validation feedback loop ("If behavior changes, restore the fixture, fix the smallest boundary, and rerun before migrating another slice"), Migration gates removal on "no callers or tests depend on it" with behavior comparison after each slice, and a Review Checklist is provided. Sequence, checkpoints, and error-recovery loops are all present, matching the top anchor.

5 / 5

Progressive Disclosure

The body is an overview that clearly signals the single one-level-deep reference ("Load [Architecture Pattern Recipes](references/architecture-patterns.md) for MVVM, MVI, TCA, Clean Architecture, Coordinator, and VIPER structure"); the reference file exists and itself contains no nested file references. A table of contents aids navigation, matching the clear-overview anchor.

5 / 5

Total

19

/

20

Passed

Description

96%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, concrete actions, explicit trigger guidance, and comprehensive pattern vocabulary. The only weakness is mild overlap risk with sibling Swift skills on a couple of trigger phrases.

DimensionReasoningScore

Specificity

"Selects, reviews, and migrates Apple-platform app architectures across MV with Observation, MVVM, MVI, TCA, Clean Architecture, Coordinator, and legacy VIPER" lists multiple concrete actions and comprehensively enumerates the pattern space it covers, matching the comprehensive-coverage anchor. Only "reviews" is slightly less concrete than the rest, which is not enough to drop to the minor-gaps anchor.

5 / 5

Completeness

The description explicitly answers what ("Selects, reviews, and migrates Apple-platform app architectures") and when ("Use when choosing module and dependency boundaries, escalating a feature beyond simple SwiftUI MV, planning incremental architecture migration, or auditing state ownership and test seams") with concrete trigger phrases. It matches the anchor-5 example's structure.

5 / 5

Trigger Term Quality

Natural user vocabulary is present throughout: "SwiftUI", "MVVM", "MVI", "TCA", "Clean Architecture", "architecture migration", "module and dependency boundaries", "state ownership", and "test seams" are exactly the phrases a Swift developer uses when asking for architectural help. This matches the comprehensive natural-terms anchor.

5 / 5

Distinctiveness Conflict Risk

The Apple-platform architecture niche with named patterns is largely distinct, but "dependency boundaries" and "test seams" carry minor overlap risk with closely related sibling skills (e.g., swift-testing, swift-concurrency). This fits the "mostly distinct; minor overlap risk" anchor rather than the minimal-conflict anchor.

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

dpearson2699/swift-ios-skills

Path

skills/swift-architecture/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.