CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

swift-architecture

Choose, review, or migrate Apple-platform architecture and module boundaries. Use when feature complexity may justify MVVM, MVI, TCA, Clean Architecture, a Coordinator, or an incremental migration beyond straightforward SwiftUI MV.

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

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 tight, high-signal architecture skill: concrete default (MV) with executable code, explicit escalation conditions, sequenced migration with validation loops, and proper one-level reference disclosure. The only nit is mild redundancy between the Pattern Selection table and the Escalation Signals section.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence (no explanations of known concepts), but the Pattern Selection table and Escalation Signals sections partially overlap — both state when to choose each pattern — and the 9-line Contents list could be trimmed. This fits anchor 4 (efficient with minor instances that could be tightened) rather than anchor 5.

4 / 5

Actionability

A complete, copy-paste-ready Swift example for the MV default (injected TripClient, @Observable store, .task wiring) covers the common case, and escalation/migration guidance is concrete ('Move one state transition or dependency at a time'). Not anchor 4: there are no gaps — the other patterns' structures are deliberately and explicitly deferred to the reference file.

5 / 5

Workflow Clarity

Decision Workflow and Migration are numbered sequences with explicit validation checkpoints and a feedback loop ('If behavior changes, restore the fixture, fix the smallest boundary, and rerun before migrating another slice'), plus a Review Checklist. Matches anchor 5's explicit validation, error-recovery loops, and checklists.

5 / 5

Progressive Disclosure

The body is a well-sectioned overview (with TOC) that keeps only decision guidance inline and defers detailed pattern structures to a real, one-level-deep references/architecture-patterns.md, clearly signaled both inline ('Load [Architecture Pattern Recipes]...') and in the References section. Matches anchor 5.

5 / 5

Total

19

/

20

Passed

Description

87%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, concrete verbs, an explicit 'Use when...' clause naming the specific patterns that justify escalation. Minor gaps only — a few natural trigger variations (iOS, VIPER, app structure) are absent from the otherwise good keyword coverage.

DimensionReasoningScore

Specificity

'Choose, review, or migrate Apple-platform architecture and module boundaries' names three concrete actions plus the domain. It falls short of anchor 5's comprehensive coverage because sub-capabilities (test seams, dependency direction, migration strategy) are only enumerated in the body, not the description; it is clearly above anchor 3's 1-2 actions.

4 / 5

Completeness

Explicitly answers both what ('Choose, review, or migrate Apple-platform architecture and module boundaries') and when with concrete trigger phrases ('Use when feature complexity may justify MVVM, MVI, TCA, Clean Architecture, a Coordinator, or an incremental migration beyond straightforward SwiftUI MV'). Matches anchor 5; anchor 4's 'when could be more explicit' does not apply.

5 / 5

Trigger Term Quality

Strong natural pattern terms ('MVVM, MVI, TCA, Clean Architecture, a Coordinator ... SwiftUI MV, architecture, module boundaries'), but a few phrases users would naturally say are missing — e.g. 'iOS app architecture', 'VIPER', 'app structure'. Fits anchor 4 (good coverage, a few natural terms missing), not anchor 5.

4 / 5

Distinctiveness Conflict Risk

A clear niche — Apple-platform architecture pattern selection — with distinctive pattern-name triggers that are unlikely to fire for sibling skills (SwiftUI wiring, navigation APIs, concurrency, test syntax), which the body explicitly routes elsewhere. Matches anchor 5's clear niche with minimal conflict risk.

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

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