swift-architecture-skill
Agent Skill for Swift architecture design and implementation patterns.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/efremidze--swift-architecture-skill)HTML
<a href="/listings/efremidze--swift-architecture-skill"><img src="/api/listings/efremidze--swift-architecture-skill/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
skills.sh (recommended)
Works with any tool that supports the [Agent Skills](https://agentskills.io) format:
npx skills add https://github.com/efremidze/swift-architecture-skill --skill swift-architecture-skill
Claude Code plugin
Install from the marketplace for personal use:
/plugin marketplace add efremidze/swift-architecture-skill /plugin install swift-architecture-skill@swift-architecture-skill
Or enable it for an entire project by committing this to `.claude/settings.json`:
{
"extraKnownMarketplaces": {
"swift-architecture-skill": {
"source": {
"source": "github",
"repo": "efremidze/swift-architecture-skill"
}
}
},
"enabledPlugins": {
"swift-architecture-skill@swift-architecture-skill": true
}
}Manual install
Clone the repo and copy the skill into your skills directory — `~/.claude/skills/` for personal use, or a project's `.claude/skills/`:
git clone https://github.com/efremidze/swift-architecture-skill.git mkdir -p ~/.claude/skills # or .claude/skills for a project cp -r swift-architecture-skill/swift-architecture-skill ~/.claude/skills/swift-architecture-skill
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 54 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- {
- "name": "swift-architecture-skill",
- "owner": {
- "name": "Lasha Efremidze",
- "email": "efremidzel@hotmail.com"
- },
- "metadata": {
- "version": "0.4.3",
- "description": "Swift iOS architecture guidance and playbooks for MVVM, MVI, TCA, Clean Architecture, VIPER, MVP, Coordinator, and Reactive patterns. Use when designing, implementing, refactoring, or reviewing the architecture of a SwiftUI or UIKit feature, module, or codebase."
- },
- "plugins": [
- {
- "name": "swift-architecture-skill",
- "description": "Swift architecture Agent Skill with playbooks for MVP, MVVM, MVI, TCA, Clean Architecture, VIPER, Coordinator, and Reactive.",
- "repository": "https://github.com/efremidze/swift-architecture-skill",
- "version": "0.4.3",
- "author": {
- "name": "Lasha Efremidze",
- "email": "efremidzel@hotmail.com"
- },
- "license": "MIT",
- "category": "development",
- "keywords": [
- "swift",
- "ios",
- "swiftui",
- "architecture",
- "mvvm",
- "mvi",
- "tca",
- "clean-architecture",
- "viper",
- "mvp",
- "coordinator",
- "reactive"
- ],
- "tags": [
- "swift",
- "ios",
- "swiftui",
- "architecture",
- "mvvm",
- "mvi",
- "tca",
- "clean-architecture",
- "viper",
- "mvp",
- "coordinator",
- "reactive"
- ],
- "source": "./swift-architecture-skill"
- }
- ]
- }
README.md · README · 137 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Swift Architecture Skill
- [](https://github.com/efremidze/swift-architecture-skill/actions/workflows/validate-skill.yml)
- [](https://agentskills.io/home)
- 
- Architecture guidance for AI coding tools — because LLMs default to MVVM for everything. This skill routes to the right pattern for your feature, keeps guidance scoped to your task, and gives you concrete code, anti-pattern fixes, and a PR checklist.
- Supports the [Agent Skills open format](https://agentskills.io/home).
- ## Features
- - **Routes to the right architecture**: Describe your feature and the skill selects the best fit based on UI stack, state complexity, and existing conventions. Name a pattern yourself and it validates the fit before you commit.
- - **Scoped playbooks**: Each architecture has its own reference — code patterns, anti-pattern fixes, testing strategy, and a PR checklist. Guidance never bleeds across patterns.
- - **SwiftUI and UIKit**: Every playbook covers both stacks with modern async/await and actor-based concurrency patterns throughout.
- - **Snippet validation**: CI parses Swift fences across the playbooks so examples stay syntactically healthy as guidance evolves.
- ## Supported Architectures
- MVP · MVVM · MVI · TCA · Clean Architecture · VIPER · Coordinator · Reactive
- Each has a dedicated [playbook](swift-architecture-skill/references/) with overview, patterns, anti-pattern fixes, testing strategy, and PR checklist.
- Use the [selection guide](swift-architecture-skill/references/selection-guide.md) when the architecture is still undecided.
- ## Installation
- ### skills.sh (recommended)
- Works with any tool that supports the [Agent Skills](https://agentskills.io) format:
- ```bash
- npx skills add https://github.com/efremidze/swift-architecture-skill --skill swift-architecture-skill
- ```
- ### Claude Code plugin
- Install from the marketplace for personal use:
- ```text
- /plugin marketplace add efremidze/swift-architecture-skill
- /plugin install swift-architecture-skill@swift-architecture-skill
- ```
- Or enable it for an entire project by committing this to `.claude/settings.json`:
- ```json
- {
- "extraKnownMarketplaces": {
- "swift-architecture-skill": {
- "source": {
- "source": "github",
- "repo": "efremidze/swift-architecture-skill"
- }
- }
- },
- "enabledPlugins": {
- "swift-architecture-skill@swift-architecture-skill": true
- }
- }
- ```
- ### Manual install
- Clone the repo and copy the skill into your skills directory — `~/.claude/skills/` for personal use, or a project's `.claude/skills/`:
- ```bash
- git clone https://github.com/efremidze/swift-architecture-skill.git
- mkdir -p ~/.claude/skills # or .claude/skills for a project
- cp -r swift-architecture-skill/swift-architecture-skill ~/.claude/skills/swift-architecture-skill
- ```
- ## Usage
- Once installed, ask your agent:
- > Use `swift-architecture-skill` to recommend and scaffold architecture for this feature.
- ## Example Prompts
- ```text
- I'm building a SwiftUI feed with pagination, pull-to-refresh, and live updates.
- Which architecture should I use and why?
- ```
- ```text
- We're planning to use TCA for a simple settings screen with two toggles.
- Is that the right call, or is it overkill for this feature?
- ```
- ```text
- This module started as MVVM but the ViewModel is doing too much — routing,
- formatting, and business logic. Use swift-architecture-skill to refactor it
- toward Clean Architecture and show me the layer boundaries.
- ```
- ```text
- We have a UIKit + MVP module we're migrating to SwiftUI. Should we keep MVP
- or switch patterns during the migration, and how do we handle the transition
- period where both coexist?
- ```
- ## Skill Structure
- ```text
- swift-architecture-skill/
- SKILL.md # Routing logic and output requirements
- references/
- selection-guide.md # Decision framework across architectures
- concurrency.md # Shared async, cancellation, and error-mapping rules
- observation.md # Shared @Observable vs ObservableObject guidance
- mvp.md # MVP playbook
- mvvm.md # MVVM playbook
- mvi.md # MVI playbook
- tca.md # TCA playbook
- clean-architecture.md # Clean Architecture playbook
- viper.md # VIPER playbook
- coordinator.md # Coordinator playbook
- reactive.md # Reactive (Combine/RxSwift) playbook
- ```
- ## Contributing
- Contributions are welcome. A few things to keep in mind:
- - **Respect the token budget.** SKILL.md is loaded on every invocation — keep additions concise.
- - **Don't repeat what LLMs already know.** Focus on edge cases, common mistakes, and pattern-specific traps that models get wrong.
- - **One playbook per pattern.** Keep guidance scoped; don't let patterns bleed into each other.
- See [CONTRIBUTING.md](CONTRIBUTING.md) for full structure and quality requirements.
- ## Related
- - [swift-patterns-skill](https://github.com/efremidze/swift-patterns-skill)
- ## License
- MIT. See [LICENSE](LICENSE) for details.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.