Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Swift Architecture · dpearson2699 | DecimalAI

codingby dpearson2699

Swift Architecture

dpearson2699/swift-architecture

Source dpearson2699/swift-ios-skills ↗License NOASSERTION

Selects, reviews, and migrates Apple-platform app architectures across MV with Observation, MVVM, MVI, TCA, Clean Architecture, Coordinator, and legacy VIPER.

SkillScore96Maintained

Automatic

Coding pack

Last verified 8/14/2026

What it changes

Passed 24 of 25 test cases with the skill, and 15 of 25 without it.

Without skill60%

With skill96%

Checks it passed that the model alone missed

Recommends defaulting new SwiftUI features to MV.
Recommends starting with MV for straightforward SwiftUI screens.
Recommends migrating feature boundaries one vertical slice at a time.

and 7 more in the full report

9 fixed15 passed either way1 still failing0 broke

Pass-rate lift: +36 pp
Tokens: +30%
Agent turns: 0%
Response time: -32%

Model gemini-3.6-flashMeasured 8/14/2026v124 of 25 cases passed with skill

Tokens, turns and time describe resource use, not a dollar price.

Use this skill

Save it into your project's skills folder. Claude Code picks it up in its next session.

curl -fsSL --create-dirs -o .claude/skills/dpearson2699-swift-architecture/SKILL.md https://app.decimal.ai/s/dpearson2699-swift-architecture/SKILL.md

Want it pinned and updatable? pip install "decimalai>=0.15", then decimalai skills add dpearson2699-swift-architecture, and start Claude Code with claude --plugin-dir "$(git rev-parse --show-toplevel)/.agents"

1 · One-time — install the CLI (docs ↗)

pip install "decimalai>=0.15"

2 · Get the skill — writes .agents/skills/dpearson2699-swift-architecture/ and pins it in .decimal/skills.lock

decimalai skills add dpearson2699-swift-architecture

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/dpearson2699-swift-architecture/SKILL.md https://app.decimal.ai/s/dpearson2699-swift-architecture/SKILL.md

Raw file: /s/dpearson2699-swift-architecture/SKILL.md ↗ · machine-readable summary at /s/dpearson2699-swift-architecture.json ↗

Safety checks: 3 of 3 passed

Code scan CleanIntent PassedContent Clean

See it in action

One of 9 test cases the skill fixed. Same model, same prompt, with and without the skill.

1 of 9

Prompt

What is the first step when evaluating whether an existing SwiftUI feature needs an architectural pattern change?

What was checked, without and with the skill
Checked	Without skill	With skill
Identifies inventorying feature state, dependencies, and side effects as the initial step.	Missed	Passed
Requires identifying concrete complexity pressure before selecting a pattern.	Passed	Passed

case-20 · gemini-3.6-flash · 8/14/2026 · answers are capped and redacted

What's inside

The instructions your model reads when the skill loads.

SKILL.md129 lines2 files

Swift Architecture

Choose the smallest architecture that makes state ownership, dependencies, side effects, and tests explicit. Default new SwiftUI features to MV; escalate only for observed complexity.

Scope Boundary
Decision Workflow
Pattern Selection
MV Default
Escalation Signals
Migration
Common Mistakes
Review Checklist
References

Scope Boundary

This skill owns pattern selection, module boundaries, dependency direction, migration strategy, and architecture-level test seams. Route SwiftUI property-wrapper wiring and view composition to swiftui-patterns, navigation APIs and route models to swiftui-navigation, isolation diagnostics to swift-concurrency, and test syntax/fixtures to swift-testing.

Decision Workflow

Record the feature's state owner, inputs, outputs, dependencies, side effects, navigation handoffs, and current tests.
Identify the concrete pressure: complex state machine, shared derived state, dependency control, feature composition, team ownership, or UIKit navigation.
Select the smallest pattern that addresses that pressure; write down what it adds and what remains unchanged.
Implement one vertical slice with injected dependencies and observable state transitions.
Run existing behavior tests plus state-transition and dependency-failure tests. If behavior changes, restore the fixture, fix the smallest boundary, and rerun before migrating another slice.

Pattern Selection

Pattern	Choose when	Main cost
MV	SwiftUI feature has straightforward state and orchestration	Logic can drift into large views without decomposition
MVVM	Presentation logic needs an independently testable adapter	Extra layer can become a forwarding shell
MVI	A feature is best modeled as explicit state + intents + reducer/effects	Boilerplate and centralized transition design
TCA	Many composable features need deterministic effects, dependencies, and testing	Framework learning and architectural commitment
Clean Architecture	Large product needs strict dependency direction across domain/data/UI	Protocol and mapping overhead
Coordinator	UIKit or hybrid navigation needs a separate flow owner	Another lifecycle and routing owner
VIPER	Maintaining an existing UIKit module with established VIPER boundaries	Very high ceremony; poor default for new SwiftUI work

Track record

Benchmark

24 / 25

test cases passed, vs 15 / 25 without

Adoption

Users: 0
Times used: 0

Safety and source details

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/3/2026

View 15 scanner checks

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

dpearson2699 / swift-ios-skills

skills/swift-architecture/SKILL.md

View on GitHub ↗

License NOASSERTIONImported 8/3/2026Version v1Bundled 1 file

More skills from the same source and nearby in the registry, with their headline benchmark lift.

Ready to supercharge your AI agents?

See it in action

What's inside

Swift Architecture

Contents

Scope Boundary

Decision Workflow

Pattern Selection

Track record

Benchmark

Adoption

SkillSafety

Source

Related skills