ojowwalker77/claude-matrix/swift-swiftui

Name: swift-swiftui
Author: ojowwalker77

Claude Code and agent skill by ojowwalker77/claude-matrix

Trust tier 2

community

LLM review pending

Source check pending

Checking that the SKILL.md file is still in the repository.

This skill should be used when the user is working with Swift or SwiftUI, asks to "write SwiftUI code", "create iOS app", "fix SwiftUI view", "help with Swift", "SwiftUI architecture", "iOS development", or needs expert-level Swift/SwiftUI guidance with modern patterns and best practices.

Install

npx vskill@latest install ojowwalker77/claude-matrix/swift-swiftui

SKILL.md

Swift & SwiftUI Expert

Expert-level guidance for Swift and SwiftUI development with modern patterns, iOS 17+/macOS 14+ best practices, and production-ready code generation.

Core Principles

When writing Swift/SwiftUI code, ALWAYS follow these principles:

1. Modern State Management (iOS 17+)

Use `@Observable` macro instead of `ObservableObject`:

swift

// MODERN (iOS 17+)
@Observable
class UserViewModel {
    var name: String = ""
    var isLoggedIn: Bool = false
}
 
// View owns the model
struct ContentView: View {
    @State private var viewModel = UserViewModel()
    var body: some View {
        Text(viewModel.name)
    }
}
 
// Child view (read-only) - NO wrapper needed
struct ProfileView: View {
    var viewModel: UserViewModel  // Just pass it
    var body: some View {
        Text(viewModel.name)
    }
}
 
// Child view (needs binding)
struct EditView: View {
    @Bindable var viewModel: UserViewModel
    var body: some View {
        TextField("Name", text: $viewModel.name)
    }
}

2. Property Wrapper Decision Tree

Use Case	Property Wrapper
Local view state (value types)	`@State`
Two-way binding to parent state	`@Binding`
Observable model (view owns)	`@State` + `@Observable` class
Observable model (read-only child)	No wrapper (just pass object)
Observable model (needs binding)	`@Bindable`
Shared app-wide state	`@Environment`
User defaults	`@AppStorage`
Scene storage	`@SceneStorage`
Focus state	`@FocusState`

3. Architecture Patterns

For most apps: Modern MVVM with @Observable For large apps with teams: TCA (Composable Architecture) For simple views: No ViewModel needed

See references/architecture.md for detailed patterns.

Anti-Patterns to AVOID

State Management

swift

// WRONG: @ObservedObject with initialization
@ObservedObject var viewModel = ViewModel()  // Will crash!
 
// RIGHT: Use @StateObject or @State
@StateObject private var viewModel = ViewModel()  // Legacy
@State private var viewModel = ViewModel()  // Modern (iOS 17+)

swift

// WRONG: @State with reference types
@State var user: User  // Where User is a class
 
// RIGHT: @State only for value types
@State var userName: String
@State private var viewModel = ViewModel()  // Only with @Observable

swift

// WRONG: Clearing data on error
func refresh() async {
    self.items = []  // Data disappears if error occurs!
    do {
        self.items = try await fetchItems()
    } catch {
        // Items now empty forever
    }
}
 
// RIGHT: Preserve existing data
func refresh() async {
    do {
        self.items = try await fetchItems()
    } catch {
        // Keep existing items, show error toast
    }
}

Performance

swift

// WRONG: Heavy computation in body
var body: some View {
    let sorted = items.sorted { ... }.filter { ... }  // Runs every render!
    List(sorted) { ... }
}
 
// RIGHT: Memoize or compute elsewhere
var sortedItems: [Item] {
    items.sorted { ... }.filter { ... }
}  // Or use @State for expensive computations

swift

// WRONG: Using id modifier on lazy content
LazyVStack {
    ForEach(items) { item in
        ItemView(item: item)
            .id(item.id)  // Breaks lazy loading!
    }
}
 
// RIGHT: Let ForEach handle identity
LazyVStack {
    ForEach(items) { item in
        ItemView(item: item)  // ForEach uses Identifiable
    }
}

Navigation

swift

// WRONG: Using deprecated NavigationView
NavigationView {
    List { ... }
}
 
// RIGHT: Use NavigationStack (iOS 16+)
NavigationStack {
    List { ... }
}

Code Generation Guidelines

When generating Swift/SwiftUI code:

Target iOS 17+/macOS 14+ unless user specifies otherwise
Use `@Observable` instead of ObservableObject/@Published
Use NavigationStack instead of NavigationView
Use `.task` instead of .onAppear for async work
Use Swift concurrency (async/await) instead of Combine for new code
Make @State private always
Prefer value types (structs, enums) over classes
Use optionals correctly - never force unwrap without safety
Handle errors explicitly - use do-catch, not try?
Add accessibility - labels, hints, traits

Reference Documents

For detailed guidance, consult:

`references/state-management.md` - Property wrappers, @Observable, data flow
`references/architecture.md` - MVVM, TCA, Clean Architecture patterns
`references/navigation.md` - NavigationStack, programmatic navigation, deep links
`references/performance.md` - Lazy views, List optimization, render cycles
`references/concurrency.md` - async/await, actors, MainActor, Task
`references/testing.md` - Unit tests, ViewInspector, UI tests
`references/accessibility.md` - VoiceOver, Dynamic Type, accessibility modifiers
`references/swiftdata.md` - @Model, @Query, persistence patterns
`references/anti-patterns.md` - Common mistakes and how to fix them

Examples

Basic View with State

swift

struct CounterView: View {
    @State private var count = 0
 
    var body: some View {
        VStack(spacing: 20) {
            Text("Count: \(count)")
                .font(.largeTitle)
 
            Button("Increment") {
                count += 1
            }
            .buttonStyle(.borderedProminent)
        }
        .accessibilityElement(children: .combine)
        .accessibilityLabel("Counter at \(count)")
        .accessibilityHint("Double tap the button to increment")
    }
}

ViewModel with @Observable

swift

@Observable
class TaskListViewModel {
    var tasks: [Task] = []
    var isLoading = false
    var errorMessage: String?
 
    @MainActor
    func loadTasks() async {
        isLoading = true
        defer { isLoading = false }
 
        do {
            tasks = try await TaskService.shared.fetchTasks()
        } catch {
            errorMessage = error.localizedDescription
        }
    }
}
 
struct TaskListView: View {
    @State private var viewModel = TaskListViewModel()
 
    var body: some View {
        NavigationStack {
            Group {
                if viewModel.isLoading {
                    ProgressView()
                } else {
                    List(viewModel.tasks) { task in
                        TaskRow(task: task)
                    }
                }
            }
            .navigationTitle("Tasks")
        }
        .task {
            await viewModel.loadTasks()
        }
    }
}

Navigation with Type-Safe Routes

swift

enum Route: Hashable {
    case detail(Item)
    case settings
    case profile(userId: String)
}
 
struct ContentView: View {
    @State private var path = NavigationPath()
 
    var body: some View {
        NavigationStack(path: $path) {
            List(items) { item in
                Button(item.name) {
                    path.append(Route.detail(item))
                }
            }
            .navigationDestination(for: Route.self) { route in
                switch route {
                case .detail(let item):
                    DetailView(item: item)
                case .settings:
                    SettingsView()
                case .profile(let userId):
                    ProfileView(userId: userId)
                }
            }
        }
    }
 
    // Programmatic navigation
    func navigateToSettings() {
        path.append(Route.settings)
    }
 
    func popToRoot() {
        path.removeLast(path.count)
    }
}

Usage

This skill activates automatically when working with Swift/SwiftUI files or when the user mentions iOS/macOS/SwiftUI development.

Explicit invocation:

/swift-swiftui help me refactor this view to use @Observable
/swift-swiftui create a settings screen with navigation
/swift-swiftui fix state management in this component

Security

Security scanPassed, 100 of 100Pattern checks on the skill's files.
Model reviewNot runA model review is scheduled for the next rescan.

See the full security report

Quality evaluation

Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

SKILL.md in the repositoryCheckingskills/swift-swiftui/SKILL.md

Popularity

Repository stars: 104
Repository forks: 9
7-day trend score: 23

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 16 Mar 2026, 7 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

Claude Code
Cursor
GitHub Copilot
Windsurf
Codex
Gemini CLI
Cline
Amp
Roo Code
Goose
Continue
Kilo Code
Junie
Trae
OpenHands
Qwen Code
AI Agent
Tabnine Chat
Sourcegraph Cody
Amazon Q
Firebase Genkit
Sweep
Devin
Phind
Mentat
Claude Desktop
Aider
GPT Pilot
Plandex
bolt.new
v0
Replit Agent
Anse
TypingMind
BetterChatGPT
LibreChat
Warp AI
Pieces
Fig AI

Embed badge

[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/ojowwalker77/claude-matrix/swift-swiftui/badge)](https://verified-skill.com/skills/ojowwalker77/claude-matrix/swift-swiftui)

Something wrong with this skill or its page? Tell us.