Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/efremidze--swift-architecture-skill/badge.svg)](/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

i

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)

  1. {
  2. "name": "swift-architecture-skill",
  3. "owner": {
  4. "name": "Lasha Efremidze",
  5. "email": "efremidzel@hotmail.com"
  6. },
  7. "metadata": {
  8. "version": "0.4.3",
  9. "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."
  10. },
  11. "plugins": [
  12. {
  13. "name": "swift-architecture-skill",
  14. "description": "Swift architecture Agent Skill with playbooks for MVP, MVVM, MVI, TCA, Clean Architecture, VIPER, Coordinator, and Reactive.",
  15. "repository": "https://github.com/efremidze/swift-architecture-skill",
  16. "version": "0.4.3",
  17. "author": {
  18. "name": "Lasha Efremidze",
  19. "email": "efremidzel@hotmail.com"
  20. },
  21. "license": "MIT",
  22. "category": "development",
  23. "keywords": [
  24. "swift",
  25. "ios",
  26. "swiftui",
  27. "architecture",
  28. "mvvm",
  29. "mvi",
  30. "tca",
  31. "clean-architecture",
  32. "viper",
  33. "mvp",
  34. "coordinator",
  35. "reactive"
  36. ],
  37. "tags": [
  38. "swift",
  39. "ios",
  40. "swiftui",
  41. "architecture",
  42. "mvvm",
  43. "mvi",
  44. "tca",
  45. "clean-architecture",
  46. "viper",
  47. "mvp",
  48. "coordinator",
  49. "reactive"
  50. ],
  51. "source": "./swift-architecture-skill"
  52. }
  53. ]
  54. }
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)

  1. # Swift Architecture Skill
  2. [![Validate Skill](https://github.com/efremidze/swift-architecture-skill/actions/workflows/validate-skill.yml/badge.svg)](https://github.com/efremidze/swift-architecture-skill/actions/workflows/validate-skill.yml)
  3. [![Agent Skills](https://img.shields.io/badge/Agent%20Skills-Compatible-purple.svg)](https://agentskills.io/home)
  4. ![Release](https://img.shields.io/github/v/release/efremidze/swift-architecture-skill)
  5. 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.
  6. Supports the [Agent Skills open format](https://agentskills.io/home).
  7. ## Features
  8. - **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.
  9. - **Scoped playbooks**: Each architecture has its own reference — code patterns, anti-pattern fixes, testing strategy, and a PR checklist. Guidance never bleeds across patterns.
  10. - **SwiftUI and UIKit**: Every playbook covers both stacks with modern async/await and actor-based concurrency patterns throughout.
  11. - **Snippet validation**: CI parses Swift fences across the playbooks so examples stay syntactically healthy as guidance evolves.
  12. ## Supported Architectures
  13. MVP · MVVM · MVI · TCA · Clean Architecture · VIPER · Coordinator · Reactive
  14. Each has a dedicated [playbook](swift-architecture-skill/references/) with overview, patterns, anti-pattern fixes, testing strategy, and PR checklist.
  15. Use the [selection guide](swift-architecture-skill/references/selection-guide.md) when the architecture is still undecided.
  16. ## Installation
  17. ### skills.sh (recommended)
  18. Works with any tool that supports the [Agent Skills](https://agentskills.io) format:
  19. ```bash
  20. npx skills add https://github.com/efremidze/swift-architecture-skill --skill swift-architecture-skill
  21. ```
  22. ### Claude Code plugin
  23. Install from the marketplace for personal use:
  24. ```text
  25. /plugin marketplace add efremidze/swift-architecture-skill
  26. /plugin install swift-architecture-skill@swift-architecture-skill
  27. ```
  28. Or enable it for an entire project by committing this to `.claude/settings.json`:
  29. ```json
  30. {
  31. "extraKnownMarketplaces": {
  32. "swift-architecture-skill": {
  33. "source": {
  34. "source": "github",
  35. "repo": "efremidze/swift-architecture-skill"
  36. }
  37. }
  38. },
  39. "enabledPlugins": {
  40. "swift-architecture-skill@swift-architecture-skill": true
  41. }
  42. }
  43. ```
  44. ### Manual install
  45. Clone the repo and copy the skill into your skills directory — `~/.claude/skills/` for personal use, or a project's `.claude/skills/`:
  46. ```bash
  47. git clone https://github.com/efremidze/swift-architecture-skill.git
  48. mkdir -p ~/.claude/skills # or .claude/skills for a project
  49. cp -r swift-architecture-skill/swift-architecture-skill ~/.claude/skills/swift-architecture-skill
  50. ```
  51. ## Usage
  52. Once installed, ask your agent:
  53. > Use `swift-architecture-skill` to recommend and scaffold architecture for this feature.
  54. ## Example Prompts
  55. ```text
  56. I'm building a SwiftUI feed with pagination, pull-to-refresh, and live updates.
  57. Which architecture should I use and why?
  58. ```
  59. ```text
  60. We're planning to use TCA for a simple settings screen with two toggles.
  61. Is that the right call, or is it overkill for this feature?
  62. ```
  63. ```text
  64. This module started as MVVM but the ViewModel is doing too much — routing,
  65. formatting, and business logic. Use swift-architecture-skill to refactor it
  66. toward Clean Architecture and show me the layer boundaries.
  67. ```
  68. ```text
  69. We have a UIKit + MVP module we're migrating to SwiftUI. Should we keep MVP
  70. or switch patterns during the migration, and how do we handle the transition
  71. period where both coexist?
  72. ```
  73. ## Skill Structure
  74. ```text
  75. swift-architecture-skill/
  76. SKILL.md # Routing logic and output requirements
  77. references/
  78. selection-guide.md # Decision framework across architectures
  79. concurrency.md # Shared async, cancellation, and error-mapping rules
  80. observation.md # Shared @Observable vs ObservableObject guidance
  81. mvp.md # MVP playbook
  82. mvvm.md # MVVM playbook
  83. mvi.md # MVI playbook
  84. tca.md # TCA playbook
  85. clean-architecture.md # Clean Architecture playbook
  86. viper.md # VIPER playbook
  87. coordinator.md # Coordinator playbook
  88. reactive.md # Reactive (Combine/RxSwift) playbook
  89. ```
  90. ## Contributing
  91. Contributions are welcome. A few things to keep in mind:
  92. - **Respect the token budget.** SKILL.md is loaded on every invocation — keep additions concise.
  93. - **Don't repeat what LLMs already know.** Focus on edge cases, common mistakes, and pattern-specific traps that models get wrong.
  94. - **One playbook per pattern.** Keep guidance scoped; don't let patterns bleed into each other.
  95. See [CONTRIBUTING.md](CONTRIBUTING.md) for full structure and quality requirements.
  96. ## Related
  97. - [swift-patterns-skill](https://github.com/efremidze/swift-patterns-skill)
  98. ## License
  99. MIT. See [LICENSE](LICENSE) for details.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.