swift-concurrency-expert
This skill diagnoses and resolves Swift Concurrency issues in modern Swift codebases through systematic triage and targeted fixes. It handles actor isolation, Sendable safety, and async/await migration while preserving existing behavior and ensuring test suite compatibility.
Swift Concurrency Expert fixes Swift 6.2+ concurrency errors by applying actor isolation, Sendable conformance, and async/await patterns.
AI-generated summary based on this skill's SKILL.md
Decision gist · record as of 2026-03-29
Swift Concurrency Expert fixes Swift 6.2+ concurrency errors by applying actor isolation, Sendable conformance, and async/await patterns. This skill diagnoses and resolves Swift Concurrency issues in modern Swift codebases through systematic triage and targeted fixes. It handles actor isolation, Sendable safety, and async/await migration while preserving existing behavior and ensuring test suite compatibility.
Use it when
- swift-concurrency-expert reviews and improves actor isolation by analyzing how your code enforces thread-safety boundaries.
- swift-concurrency-expert explains Sendable safety and guides you through adding Sendable conformance to types that cross actor boundaries.
Verify before relying
Read SKILL.md below before installing (5 files). Open directory: indexed for reading, not audited.
Install
Dimillian/Skills/swift-concurrency-expert · repository language: Shell
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I fix swift concurrency errors in my codebase?
swift-concurrency-expert helps you systematically diagnose and resolve Swift Concurrency issues by identifying actor isolation violations, data-race warnings, and Sendable compliance problems. The skill guides you through targeted fixes that preserve existing behavior while ensuring your code meets Swift 6.2 concurrency requirements and maintains test suite compatibility.
What is actor isolation and how do I review it?
swift-concurrency-expert reviews and improves actor isolation by analyzing how your code enforces thread-safety boundaries. It identifies where actors are properly isolated, detects cross-actor data access that violates isolation, and recommends corrections to ensure data-race warnings are resolved and your code follows Swift concurrency best practices.
How do I add Sendable conformance to my types?
swift-concurrency-expert explains Sendable safety and guides you through adding Sendable conformance to types that cross actor boundaries. It helps you understand which types need Sendable adoption, how to make them conform safely, and how to resolve compiler diagnostics related to non-Sendable data being passed between isolated contexts.
How should I migrate completion handlers to async/await?
swift-concurrency-expert supports migration of legacy completion handlers to async/await patterns by showing you how to refactor callback-based APIs into modern structured concurrency. It demonstrates proper async/await syntax, helps you avoid common pitfalls during migration, and ensures your test suite remains compatible throughout the transition.
When should I use @MainActor vs nonisolated annotations?
swift-concurrency-expert clarifies when to apply @MainActor and nonisolated annotations correctly. @MainActor isolates code to the main thread for UI work; nonisolated opts out of actor isolation for specific methods. The skill helps you choose the right annotation based on your code's threading requirements and concurrency safety needs.
What are Swift 6.2 concurrency best practices?
swift-concurrency-expert teaches Swift 6.2 concurrency best practices including proper actor design, Sendable compliance strategies, and structured concurrency patterns. It helps you understand strict concurrency checking, avoid data-race diagnostics, and build robust concurrent systems that leverage Swift's type-safe concurrency model.
SKILL.md
Rendered from the published skill. Quoted content, verbatim.
Swift Concurrency Expert
Overview
Review and fix Swift Concurrency issues in Swift 6.2+ codebases by applying actor isolation, Sendable safety, and modern concurrency patterns with minimal behavior changes.
Workflow
1. Triage the issue
- Capture the exact compiler diagnostics and the offending symbol(s).
- Check project concurrency settings: Swift language version (6.2+), strict concurrency level, and whether approachable concurrency (default actor isolation / main-actor-by-default) is enabled.
- Identify the current actor context (
@MainActor,actor,nonisolated) and whether a default actor isolation mode is enabled. - Confirm whether the code is UI-bound or intended to run off the main actor.
2. Apply
(truncated - see the full file via the links below)
File tree — 5 files
swift-concurrency-expert/SKILL.md
swift-concurrency-expert/agents/openai.yaml
swift-concurrency-expert/references/approachable-concurrency.md
swift-concurrency-expert/references/swift-6-2-concurrency.md
swift-concurrency-expert/references/swiftui-concurrency-tour-wwdc.md
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Fix Swift concurrency compiler errors and data-race warnings”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
This skill helps developers resolve Swift concurrency compiler diagnostics, data-race warnings, and isolation boundary issues. It provides structured guidance for refactoring callback-based code to async/await patterns and supports Swift 6 migration across tasks, actors, @MainActor, Sendable conformance, and thread-safety concerns. The skill emphasizes smallest-safe-change fixes grounded in project settings and isolation context.
This skill guides you through Swift 6.2's "Approachable Concurrency" features that simplify strict concurrency adoption. Discover how default MainActor inference eliminates manual annotations, how async functions now stay on their calling actor, and how to use @concurrent for explicit background execution. Perfect for migrating from Swift 6.0/6.1 or resolving data-race errors with the latest toolchain.
This skill guides developers through converting legacy iOS applications from Objective-C to Swift, covering the technical and architectural decisions needed for a successful transition. Learn strategies for managing dependencies, refactoring code patterns, and maintaining app stability during the migration process.
Master Swift 6.2's concurrency paradigm where code executes on a single thread by default and background work requires explicit opt-in via @concurrent. This skill teaches you how async functions now remain on their calling actor, eliminating the implicit offloading that caused data-race errors in earlier versions. Learn to use isolated conformances for MainActor types, protect global state, and migrate existing projects incrementally while leveraging the compiler's safety guarantees.
axiom-concurrency equips AI coding assistants with expert-level Swift 6 concurrency knowledge to eliminate data races and isolation violations. This skill covers modern async/await patterns, actor isolation, and sendability constraints—essential for building robust Apple OS applications. Prevent crashes and memory issues before they reach users.
This skill systematically scans Swift codebases for concurrency anti-patterns that cause data races, UI freezes, and resource leaks. It maps isolation architecture, identifies unsafe task captures and delegate patterns, verifies actor boundaries, and flags missing concurrency safeguards—then cross-references findings to surface compound risks that static analysis alone might miss.
More skills swift-concurrency-6-2 (MIT) · concurrency-patterns (MIT) · modern-swift (MIT) · Swift 6 Paradigm Shift (unlicensed) · review-swarm (MIT)