Swift Architecture Skill plugin
Swift Architecture Skill picks a Swift feature architecture from eight patterns with a code playbook and PR checklist.
- 82 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- The skill gives instructions and runs nothing itself.
- The session hook in the repository serves the development of the skill itself.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/swift-architecture-skillDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The skill gives instructions and runs nothing itself.
- The session hook in the repository serves the development of the skill itself.
This is third-party code. Review the repository files before installing.
What it does
Swift Architecture Skill is a skill for agents that suggest MVVM for everything by default. You describe a feature and it picks the fitting option by UI stack, state complexity and existing conventions. If you name a pattern yourself, the skill checks the fit before you commit. It supports MVP, MVVM, MVI, TCA, Clean Architecture, VIPER, Coordinator and Reactive. Each has its own playbook with an overview, code patterns, anti-pattern fixes, a testing strategy and a PR checklist, and the playbooks cover SwiftUI and UIKit and modern concurrency with async/await and actors. Guidance does not bleed between patterns. CI parses the Swift blocks in the playbooks so examples stay syntactically correct.
Who it is for. iOS developers who want an agent to suggest an architecture for a specific feature and show code checked against a PR checklist.
Good fit when
- A feed with pagination, pull-to-refresh and live updates requires choosing an architecture.
- A team wants TCA for a simple settings screen and has to judge whether it is overkill.
- An MVVM module is overloaded with routing and formatting and is moved toward Clean Architecture.
- A UIKit MVP module is migrated to SwiftUI and you decide whether to change the pattern.
Not a fit when
- Code for specific visual design is needed: the skill covers structure.
- The project is not Swift: the playbooks are written for Swift, SwiftUI and UIKit.
- A ready architecture of the whole app is needed: the skill handles one feature or module.
Example request
Use swift-architecture-skill: recommend an architecture for a SwiftUI feed with pagination and pull-to-refresh and explain the choice.Limitations
The skill works as an instruction for an agent, it does not compile code or run project tests. Playbook examples are checked in CI for syntax only and are not built in your project. The recommendation depends on what you told the agent about the stack and state, so describe the feature in detail. The `npx skills add` command reports installs to the skills.sh leaderboard unless `DISABLE_TELEMETRY=1` is set. The last commit was made on 28 September 2026.
How to disable. Remove the plugin with `/plugin uninstall swift-architecture-skill@swift-architecture-skill` or the `swift-architecture-skill` folder from `~/.claude/skills/` or the project `.claude/skills/`.
FAQ
How do I install the skill?
With `npx skills add https://github.com/efremidze/swift-architecture-skill --skill swift-architecture-skill`. In Claude Code there is a route through `/plugin marketplace add efremidze/swift-architecture-skill`.
Which architectures are supported?
MVP, MVVM, MVI, TCA, Clean Architecture, VIPER, Coordinator and Reactive. Each has its own playbook.
What does the skill do if I name a pattern?
It checks whether the pattern fits the feature before you commit to it.
Are SwiftUI and UIKit covered?
Yes, each playbook describes both stacks with async/await and actor-based concurrency.
How do I enable the skill for a whole project?
Commit `extraKnownMarketplaces` and `enabledPlugins` entries with `swift-architecture-skill@swift-architecture-skill` to `.claude/settings.json`.
Discussion
No questions or reviews yet.
Related
PluginsA set of skills for iOS 26+, Swift 6.3 and SwiftUI that gives the agent knowledge of modern Apple frameworks
A skill that gives the agent Apple's own SwiftUI guidance, which the installer extracts from your local Xcode
Paul Hudson's skill for reviewing and writing SwiftUI for iOS 26: deprecated APIs, data flow, navigation, accessibility, performance
A SwiftUI best practices skill: state, view composition, performance, new APIs, Liquid Glass and Instruments trace analysis
Skills for Apple development: SwiftUI, UIKit and Liquid Glass references, Swift 6 guides and a router for iOS 26+ tasks
SwiftUI Design Skill
swiftui-design-skill
A SwiftUI interface design skill: compilable code, tokens, patterns and six rules against AI sloppiness. One-command installation through npx skills
README in short
The README covers the skill features, eight supported architectures, installation through skills.sh, the Claude Code plugin and manually, example prompts and a directory layout with references on architecture choice, concurrency and observation.