Skip to content
Back to search

claude-swift-engineering

MarketplaceWorks with Claude CodeGitHub

A collection of agents and skills to aid in the planning, implementation, documentation and testing of Swift/TCA code.

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/johnrogers-claude-swift-engineering/badge.svg)](/listings/johnrogers-claude-swift-engineering)

HTML

<a href="/listings/johnrogers-claude-swift-engineering"><img src="/api/listings/johnrogers-claude-swift-engineering/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.

Installation

Add the plugin to Claude Code:

# Add marketplace source
/plugin marketplace add https://github.com/johnrogers/claude-swift-engineering

# Install swift-engineering plugin
/plugin install swift-engineering

Hooks (Optional)

Enable skill/agent evaluation hooks for better workflow discipline:

# 1. Symlink hooks-scripts to ~/.claude
ln -s /path/to/claude-swift-engineering/plugins/swift-engineering/hooks-scripts ~/.claude/hooks-scripts

# 2. Add to ~/.claude/settings.json
{
  "hooks": {
    "UserPromptSubmit": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "cat ~/.claude/hooks-scripts/UserPromptSubmit/skill-forced-eval-hook.sh"
          },
          {
            "type": "command",
            "command": "cat ~/.claude/hooks-scripts/UserPromptSubmit/agent-forced-eval-hook.sh"
          }
        ]
      }
    ]
  }
}

See [plugins/swift-engineering/hooks-scripts/README.md](plugins/swift-engineering/hooks-scripts/README.md) for complete hook documentation.

See [plugins/swift-engineering/README.md](plugins/swift-engineering/README.md) for complete documentation on using agents and available workflows.

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 · 49 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": "claude-swift-engineering",
  3. "metadata": {
  4. "description": "A marketplace containing Swift plugin(s) related to the Swift engineering craft."
  5. },
  6. "source": {
  7. "source": "github",
  8. "repo": "claude-swift-engineering"
  9. },
  10. "owner": {
  11. "name": "John Rogers"
  12. },
  13. "repository": "https://github.com/johnrogers/",
  14. "license": "MIT",
  15. "keywords": ["swift", "engineering", "mobile", "ios", "watchos", "software development", "software engineering", "tca"],
  16. "plugins": [
  17. {
  18. "name": "swift-engineering",
  19. "description": "A collection of agents and commands to aid in the planning, implementation, documentation and testing of Swift/TCA code.",
  20. "version": "0.1.0",
  21. "author": {
  22. "name": "John Rogers (@johnrogers)"
  23. },
  24. "source": "./plugins/swift-engineering",
  25. "category": "development",
  26. "keywords": [
  27. "swift",
  28. "apple",
  29. "ios",
  30. "ipados",
  31. "macos",
  32. "tvos",
  33. "visionos",
  34. "watchos"
  35. ],
  36. "tags": [
  37. "swift",
  38. "apple",
  39. "ios",
  40. "ipados",
  41. "macos",
  42. "tvos",
  43. "visionos",
  44. "watchos"
  45. ],
  46. "strict": false
  47. }
  48. ]
  49. }
README.md · README · 155 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # claude-swift-engineering
  2. [![License](https://img.shields.io/badge/license-MIT-green)](#) [![Platform](https://img.shields.io/badge/platform-iOS%2026%2B%20%7C%20macOS-blue)](#)
  3. > Claude Code plugin marketplace for modern Swift/SwiftUI development
  4. A specialized AI toolkit for building professional iOS/macOS features with modern Swift 6.2, TCA (The Composable Architecture), and SwiftUI. This plugin provides ultra-specialized agents that orchestrate planning, implementation, testing, and deployment.
  5. ## Swift Engineering Plugin
  6. The **swift-engineering plugin** is a production-ready toolkit for professional Swift development:
  7. - **12 Ultra-Specialized Agents** — Planning (Opus), implementation (Inherit), utilities (Haiku) with clear handoffs
  8. - **TCA Support** — Full workflow from architecture design to testing for The Composable Architecture
  9. - **Modern Swift 6.2** — iOS 26+ with strict concurrency, async/await, actors, Sendable
  10. - **Code Quality** — Integrated code review, accessibility compliance, and performance checks
  11. - **Knowledge Skills** — 18 specialized knowledge bases covering architecture patterns, frameworks, design, and development tools
  12. ## Quick Start
  13. ### Installation
  14. Add the plugin to Claude Code:
  15. ```bash
  16. # Add marketplace source
  17. /plugin marketplace add https://github.com/johnrogers/claude-swift-engineering
  18. # Install swift-engineering plugin
  19. /plugin install swift-engineering
  20. ```
  21. ### Hooks (Optional)
  22. Enable skill/agent evaluation hooks for better workflow discipline:
  23. ```bash
  24. # 1. Symlink hooks-scripts to ~/.claude
  25. ln -s /path/to/claude-swift-engineering/plugins/swift-engineering/hooks-scripts ~/.claude/hooks-scripts
  26. # 2. Add to ~/.claude/settings.json
  27. {
  28. "hooks": {
  29. "UserPromptSubmit": [
  30. {
  31. "hooks": [
  32. {
  33. "type": "command",
  34. "command": "cat ~/.claude/hooks-scripts/UserPromptSubmit/skill-forced-eval-hook.sh"
  35. },
  36. {
  37. "type": "command",
  38. "command": "cat ~/.claude/hooks-scripts/UserPromptSubmit/agent-forced-eval-hook.sh"
  39. }
  40. ]
  41. }
  42. ]
  43. }
  44. }
  45. ```
  46. See [plugins/swift-engineering/hooks-scripts/README.md](plugins/swift-engineering/hooks-scripts/README.md) for complete hook documentation.
  47. See [plugins/swift-engineering/README.md](plugins/swift-engineering/README.md) for complete documentation on using agents and available workflows.
  48. ## What's Included
  49. ### 12 Specialized Agents
  50. | Type | Agents | Responsibility |
  51. |------|--------|-----------------|
  52. | **Planning** | @swift-ui-design, @swift-architect, @tca-architect | Architecture decisions (Opus, read-only) |
  53. | **Implementation** | @tca-engineer, @swift-engineer, @swiftui-specialist, @swift-test-creator, @documentation-generator, @swift-code-reviewer, @swift-modernizer | Code creation and review (Inherit) |
  54. | **Utilities** | @swift-documenter, @search | API documentation and code search (Haiku) |
  55. ### 18 Knowledge Skills
  56. Architecture patterns (TCA, SwiftUI, modern Swift, advanced gestures), frameworks (SQLite, GRDB, StoreKit, networking), platform design (iOS 26, HIG, localization, haptics), and development tools (testing, style, diagnostics). Each skill provides deep guidance on modern patterns and best practices.
  57. ## For Contributors
  58. ### Repository Structure
  59. ```
  60. claude-swift-engineering/
  61. ├── .claude-plugin/
  62. │ └── marketplace.json # Marketplace configuration
  63. ├── .github/workflows/ # CI/CD pipelines
  64. ├── plugins/
  65. │ └── swift-engineering/ # Main plugin
  66. │ ├── agents/ # 12 specialized agents
  67. │ ├── skills/ # 18 comprehensive skills
  68. │ ├── hooks-scripts/ # Hooks system
  69. │ ├── scripts/ # Helper utilities
  70. │ ├── rules/ # Development rules
  71. │ └── README.md # Plugin documentation
  72. └── worktrees/ # Git worktrees for features
  73. ```
  74. ### Development Workflow
  75. #### Bumping Version
  76. When making changes, increment the plugin version:
  77. ```bash
  78. bash plugins/swift-engineering/scripts/bump-plugin-version.sh <new-version>
  79. ```
  80. This updates version numbers across plugin.json, marketplace.json, and other metadata files.
  81. #### Adding Agents or Skills
  82. 1. Create new agent or skill file following existing patterns (see examples in `agents/` or `skills/`)
  83. 2. Update `plugin.json` if defining new tool capabilities
  84. 3. Run smoke tests to validate configuration
  85. 4. Update both README files (root and plugin)
  86. 5. Test integration with the workflow
  87. ### Code Organization
  88. - **Agents** (`agents/`) — Each agent has a `.md` file with metadata and instructions
  89. - **Skills** (`skills/`) — Knowledge resources agents reference, organized by topic
  90. - **Hooks** (`hooks-scripts/`) — Executable hooks that enforce workflows
  91. - **Scripts** (`scripts/`) — Utility shell scripts for automation
  92. - **Rules** (`rules/`) — Development practices and decision-making frameworks
  93. - **Documentation** (`docs/`) — Smoke tests and validation suite
  94. ## Architecture & Design Principles
  95. The plugin implements several key principles:
  96. - **Ultra-Specialization** — Each agent has one clear responsibility with defined handoffs
  97. - **Model Stratification** — Opus for architecture (best reasoning), Inherit for implementation (cost-effective), Haiku for utilities (fast)
  98. - **Local-First** — Default to SQLite and UserDefaults, never SwiftData or Core Data
  99. - **Modern Swift Only** — Swift 6.2 with strict concurrency, no deprecated APIs
  100. - **Read-Only Planning** — Planning agents cannot modify code, ensuring clear separation
  101. - **Plan File Coordination** — Agents share state via `docs/plans/<feature>.md`
  102. See [plugins/swift-engineering/README.md](plugins/swift-engineering/README.md) for architecture details, workflow diagrams, and handoff models.
  103. ## License
  104. MIT License — See [LICENSE](LICENSE) file for details.
  105. ## Credits
  106. **Author:** John Rogers
  107. **Repository:** claude-swift-engineering
  108. **Swift Version:** 6.2+
  109. **iOS Deployment Target:** 26.0+
  110. ---
  111. For detailed documentation, agent specifications, and usage examples, see [plugins/swift-engineering/README.md](plugins/swift-engineering/README.md).

Ratings and comments

Sign in to rate this skill.

Sign in

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