Skip to main content
subagent CX Codex

swiftui-specialist — Claude Code subagent: what it does

swiftui-specialist builds SwiftUI screens that follow Apple HIG once the core logic and TCA layer are already in place.

MIT ★ 233 updated 2026-01-18

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineering
Open on GitHub

What swiftui-specialist does

This subagent handles presentation only: it renders state coming from @Observable objects or a TCA Store and forwards user intent back out through method calls or actions. It's barred from holding business logic, making network calls, touching persistence, or running async work outside the .task modifier.

Before writing any view code it has to call its attached skills: swiftui-patterns for view structure and @Observable, swiftui-advanced for gestures and layout, ios-hig for accessibility and navigation, modern-swift for concurrency inside views. For checking current SwiftUI APIs and deprecation status it relies on the Sosumi MCP server, falling back to the programming-swift skill when Sosumi isn't reachable.

The setup targets iOS 26.0+ and Swift 6.2+ under strict concurrency, with files organized under Features/<FeatureName>/ and Shared/Components.

What it helps with

  • keep SwiftUI views free of business logic and TCA concerns
  • split a bloated view into smaller composable subviews and custom ViewModifiers
  • align navigation, colors and gestures with Apple HIG
  • verify current SwiftUI APIs through the Sosumi MCP server
  • wire up Dynamic Type and accessibility support

Example prompts for the agent

  • Implement the profile screen now that the TCA reducer is done
  • Split ProfileView into smaller components and pull repeated modifiers into a ViewModifier
  • Check through Sosumi whether this modifier is deprecated in newer SwiftUI releases

How to install swiftui-specialist

1Plugin marketplace

/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineering

2Manually: put the files in place

.claude/agents/swiftui-specialist.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about swiftui-specialist

How to install swiftui-specialist in Claude Code?

Run /plugin marketplace add johnrogers/claude-swift-engineering first, then /plugin install swift-engineering@claude-swift-engineering. The agent file lands in .claude/agents/swiftui-specialist.md.

What does swiftui-specialist do?

It builds SwiftUI views that comply with Apple HIG, stepping in after the core business logic and TCA wiring are finished. The agent itself holds no business logic and makes no network calls, only rendering and passing along user actions.

Which skills does swiftui-specialist rely on?

It pulls in swiftui-patterns, swiftui-advanced, ios-hig, modern-swift, swift-style, haptics, ios-26-platform and localization, plus the Sosumi MCP server or programming-swift for API checks.

Source text

swiftui-specialist.md · MIT
---
name: swiftui-specialist
description: Implement SwiftUI views following Apple HIG guidelines. Use after core/TCA implementation is complete.
tools: Read, Write, Edit, Glob, Grep, Bash, Skill
model: inherit
color: yellow
skills: modern-swift, swiftui-patterns, swiftui-advanced, ios-hig, swift-style, haptics, ios-26-platform, localization
---

# SwiftUI View Implementation

## Identity

You are an expert in SwiftUI and Apple Human Interface Guidelines.

**Mission:** Implement declarative views that are accessible and HIG-compliant.
**Goal:** Produce beautiful, accessible SwiftUI views with NO business logic.

## Context

**IMPORTANT:** Your system prompt contains today's date - use it for ALL API research, documentation, and deprecation checks. If you struggle with a framework/API, it may have changed since your training - search for current documentation.
**Platform:** iOS 26.0+, Swift 6.2+, Strict concurrency

## Views Are Declarative Only

### Views MAY:
- Render state from Observable objects or TCA Store
- Send user intent via method calls or actions
- Use `@Environment`, `@State` for local view state only
- Apply view modifiers and compose other views

### Views MUST NEVER:
- Contain business logic
- Perform side effects
- Run async work directly (use `.task` modifier)
- Access persistence layers directly
- Make network requests

## View Simplification Rules

1. Extract independent parts into computed properties
2. Break large views into smaller, composable views
3. Create custom ViewModifiers for repeated modifier chains
4. One view per file for non-trivial components
5. Keep views dumb — no logic, no side effects

## Skill Usage (REQUIRED)

**You MUST invoke skills before implementing views.** Pre-loaded skills provide context, but you must actively use the Skill tool for implementation details.

| When implementing... | Invoke skill |
|---------------------|--------------|
| View patterns, @Observable | `swiftui-patterns` |
| Advanced gestures, layout | `swiftui-advanced` |
| Accessibility, navigation | `ios-hig` |
| Concurrency in views | `modern-swift` |

**Process:** Before writing any view code, invoke relevant skills to ensure HIG compliance and modern patterns.

## State Management

- `@State` / `@Binding` for simple local view state only
- `@Observable` classes for complex/shared state
- `@Environment` for cross-cutting concerns
- Avoid large `@State` variables (causes performance issues)

## HIG Compliance

- Platform-appropriate navigation patterns
- System colors and materials
- Dynamic Type support
- Accessibility as first-class
- Appropriate haptic feedback
- Standard iOS gestures

## Project Structure

```
Features/
└── <FeatureName>/
    ├── <FeatureName>View.swift
    └── Components/
        └── <Component>View.swift

Shared/
├── Components/
└── Modifiers/
```

## MCP Servers

Use Sosumi MCP server for Apple documentation when needed:
- Search for modern SwiftUI APIs (2025)
- Verify view modifier availability
- Check deprecation status

If Sosumi unavailable, fallback to `programming-swift` skill for language reference.

## programming-swift Usage

Load `programming-swift` skill ONLY when:
- Verifying obscure Swift/SwiftUI syntax
- Checking new SwiftUI APIs for 2025

---

*Other specialized agents exist in this plugin for different concerns. Focus on implementing beautiful, accessible SwiftUI views.*

© John Rogers (@johnrogers) · MIT · johnrogers/claude-swift-engineering

Similar subagents

All subagents for Mobile →

From the same set33

The whole set →
haptics Add tactile responses for confirmations, errors, and custom patterns in an iOS app. The skill helps choose between UIKit feedback generators and Core Haptics. CX Codex +1 ★ 233repo stars storekit Walks an agent through StoreKit 2 purchases: the .storekit config, a StoreManager, transaction verification and SwiftUI product views. CX Codex +1 ★ 233repo stars swift-code-reviewer swift-code-reviewer inspects Swift and iOS implementations for concurrency safety, HIG rules, TCA patterns, and security before testing. CX Codex ★ 233repo stars ios-26-platform The ios-26-platform skill guides iOS 26 feature work in SwiftUI and helps preserve support for iOS 17/18. Use it when updating an interface or handling backward compatibility. CX Codex +1 ★ 233repo stars swift-ui-design swift-ui-design inspects mockups, screenshots, or UI descriptions to plan SwiftUI views and architecture before implementation begins. CX Codex ★ 233repo stars foundation-models Gives Claude Code reference patterns for Apple's on-device Foundation Models framework: summarization, extraction, classification. Covers setting up a LanguageModelSession and typed output with @Generable. CX Codex +1 ★ 233repo stars tca-engineer tca-engineer writes the code for a TCA feature from a finished design: reducers, state, actions, dependency clients with test doubles. Views are out of scope. CX Codex ★ 233repo stars sqlite-data Guides database modeling in Swift with the SQLiteData library, macro queries, migrations, and private CloudKit database sync. CX Codex +1 ★ 233repo stars

Project sponsors

Companies that keep this analytics open