swift-optimise — Claude Code skill: use and install
The swift-optimise skill reviews Swift and SwiftUI performance across concurrency, rendering, and animation. Use it while profiling clinic modules.
MIT 293 installs ★ 227 updated 2026-08-15
npx skills add pproenca/dot-skills --skill swift-optimise -a claude-codeWhat swift-optimise does
swift-optimise groups 19 rules into concurrency and async work, render and scroll performance, and animation performance. It covers moving from Combine publishers to async/await, applying Sendable and actor isolation, using @MainActor, limiting view invalidation, and choosing lazy containers, Canvas, or TimelineView.
The skill points to separate reference files with explanations and code samples. Its guidance targets Swift 6.2, iOS 26, @Observable, and Swift 6 strict concurrency. It keeps the module boundaries of the clinic MVVM-C setup across App, Feature, Domain, and Data.
That architecture is an assumption of the skill, so projects with different module boundaries will need the recommendations adjusted. It also puts SwiftUI Instruments profiling before changes are made.
What it helps with
- replace Combine publishers with async/await
- adopt Sendable and actor isolation
- cut down needless SwiftUI redraws
- improve scrolling through large collections
- build smoother spring animations and transitions
Example prompts for the agent
- Use the skill to inspect SwiftUI performance in this clinic module and suggest focused changes.
- Migrate this Combine publisher to async/await under Swift 6 strict concurrency.
- Find the source of unnecessary list redraws while preserving the App, Feature, Domain, and Data boundaries.
How to install swift-optimise
1Skills CLI (Vercel)
npx skills add pproenca/dot-skills --skill swift-optimise -a claude-code2Manually: put the files in place
~/.claude/skills/swift-optimise/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/swift-optimise/
1Skills CLI (Vercel)
npx skills add pproenca/dot-skills --skill swift-optimise -a codex2Manually: put the files in place
.agents/skills/swift-optimise/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add pproenca/dot-skills --skill swift-optimise -a cursor2Manually: put the files in place
.cursor/skills/swift-optimise/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install pproenca/dot-skills skills/.experimental/swift-optimise2Manually: put the files in place
.github/skills/swift-optimise/SKILL.md1Skills CLI (Vercel)
npx skills add pproenca/dot-skills --skill swift-optimise -a gemini-cli2Platform CLI
gemini skills install https://github.com/pproenca/dot-skills --path skills/.experimental/swift-optimiseManually: put the files in place
.devin/skills/swift-optimise/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add pproenca/dot-skills --skill swift-optimise -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about swift-optimise
How do I install swift-optimise in Claude Code?
Run npx skills add pproenca/dot-skills --skill swift-optimise -a claude-code. The skill file will be placed at ~/.claude/skills/swift-optimise/SKILL.md.
What does swift-optimise do?
It provides Swift and SwiftUI performance rules for async/await, Sendable, actor isolation, rendering, scrolling, and animation. The material is arranged as 19 rules across three categories.
Which Swift and iOS versions does the skill target?
The guidance targets Swift 6.2, iOS 26, @Observable, and Swift 6 strict concurrency.
Source text
SKILL.md · MIT
--- name: swift-optimise description: Swift 6.2 and SwiftUI performance optimization for iOS 26 clinic architecture codebases. Covers async/await concurrency patterns, Sendable/actor isolation, view/render performance, and animation performance while preserving modular MVVM-C boundaries across App, Feature, Domain, and Data layers. Use when profiling or optimizing Swift/SwiftUI behavior in clinic modules. --- # Apple Swift/SwiftUI Performance Optimization Best Practices Comprehensive guide for Swift and SwiftUI performance optimization. Contains 19 rules across 3 categories covering modern concurrency, render performance, and animation performance. Targets iOS 26 / Swift 6.2 with @Observable and Swift 6 strict concurrency. ## Clinic Architecture Contract (iOS 26 / Swift 6.2) All guidance in this skill assumes the clinic modular MVVM-C architecture: - Feature modules import `Domain` + `DesignSystem` only (never `Data`, never sibling features) - App target is the convergence point and owns `DependencyContainer`, concrete coordinators, and Route Shell wiring - `Domain` stays pure Swift and defines models plus repository, `*Coordinating`, `ErrorRouting`, and `AppError` contracts - `Data` owns SwiftData/network/sync/retry/background I/O and implements Domain protocols - Read/write flow defaults to stale-while-revalidate reads and optimistic queued writes - ViewModels call repository protocols directly (no default use-case/interactor layer) ## When to Apply Reference these guidelines when: - Migrating to Swift 6 strict concurrency (Sendable, actor isolation) - Replacing Combine publishers with async/await - Implementing @MainActor isolation and actor-based concurrency - Decomposing views to reduce state invalidation blast radius - Optimizing scroll and render performance with lazy containers - Using Canvas/TimelineView for high-performance rendering - Profiling with SwiftUI Instruments before optimizing - Building performant spring animations and transitions ## Rule Categories by Priority | Priority | Category | Impact | Prefix | |----------|----------|--------|--------| | 1 | Concurrency & Async | CRITICAL | `conc-` | | 2 | Render & Scroll Performance | HIGH | `perf-` | | 3 | Animation Performance | MEDIUM | `anim-` | ## Quick Reference ### 1. Concurrency & Async (CRITICAL) - [`conc-combine-to-async`](references/conc-combine-to-async.md) - Replace Combine publishers with async/await - [`conc-mainactor-isolation`](references/conc-mainactor-isolation.md) - Use @MainActor instead of DispatchQueue.main - [`conc-swift6-sendable`](references/conc-swift6-sendable.md) - Adopt Sendable and Swift 6 strict concurrency - [`conc-task-id-pattern`](references/conc-task-id-pattern.md) - Use .task(id:) for reactive data loading - [`conc-actor-for-shared-state`](references/conc-actor-for-shared-state.md) - Replace lock-based shared state with actors - [`conc-asyncsequence-streams`](references/conc-asyncsequence-streams.md) - Replace NotificationCenter observers with AsyncSequence ### 2. Render & Scroll Performance (HIGH) - [`perf-view-decomposition`](references/perf-view-decomposition.md) - Decompose views to limit state invalidation blast radius - [`perf-instruments-profiling`](references/perf-instruments-profiling.md) - Profile with SwiftUI Instruments before optimizing - [`perf-lazy-containers`](references/perf-lazy-containers.md) - Use lazy containers for large collections - [`perf-canvas-timeline`](references/perf-canvas-timeline.md) - Use Canvas and TimelineView for high-performance rendering - [`perf-drawinggroup`](references/perf-drawinggroup.md) - Use drawingGroup for complex graphics - [`perf-equatable-views`](references/perf-equatable-views.md) - Add Equatable conformance to prevent spurious redraws - [`perf-task-modifier`](references/perf-task-modifier.md) - Use .task modifier instead of .onAppear for async work - [`perf-async-image`](references/perf-async-image.md) - Use AsyncImage with caching strategy for remote images ### 3. Animation Performance (MEDIUM) - [`anim-spring`](references/anim-spring.md) - Use spring animations as default - [`anim-matchedgeometry`](references/anim-matchedgeometry.md) - Use matchedGeometryEffect for shared transitions - [`anim-gesture-driven`](references/anim-gesture-driven.md) - Make animations gesture-driven - [`anim-with-animation`](references/anim-with-animation.md) - Use withAnimation for state-driven transitions - [`anim-transition-effects`](references/anim-transition-effects.md) - Apply transition effects for view insertion and removal ## How to Use Read individual reference files for detailed explanations and code examples: - [Section definitions](references/_sections.md) - Category structure and impact levels - [Rule template](assets/templates/_template.md) - Template for adding new rules ## Reference Files | File | Description | |------|-------------| | [references/_sections.md](references/_sections.md) | Category definitions and ordering | | [assets/templates/_template.md](assets/templates/_template.md) | Template for new rules |
© pproenca · MIT · pproenca/dot-skills