$npx -y skills add kylehughes/the-unofficial-swift-concurrency-migration-skill --skill migrating-to-swift-concurrencyProvides the complete Swift Concurrency Migration Guide. Use when migrating to Swift 6, resolving data-race safety errors, understanding Sendable and actor isolation, or incrementally adopting async/await.
| 1 | # Swift Concurrency Migration Guide |
| 2 | |
| 3 | The complete content of the Swift Concurrency Migration Guide by Apple. This guide helps you migrate your code to take advantage of Swift's data-race safety guarantees and the Swift 6 language mode. |
| 4 | |
| 5 | ## Documentation |
| 6 | |
| 7 | - **Data Race Safety** ([Guide/DataRaceSafety.md](Guide/DataRaceSafety.md)): Learn about the fundamental concepts Swift uses to enable data-race-free |
| 8 | - **Migration Strategy** ([Guide/MigrationStrategy.md](Guide/MigrationStrategy.md)): Get started migrating your project to the Swift 6 language mode. |
| 9 | - **Enable data-race safety checking** ([Guide/EnableDataRaceSafety.md](Guide/EnableDataRaceSafety.md)): Use Swift 6 to get full data-race safety checking or add checking to an existing Swift 5 project. |
| 10 | - **Common Compiler Errors** ([Guide/CommonProblems.md](Guide/CommonProblems.md)): Identify, understand, and address common problems you can encounter while |
| 11 | - **Incremental Adoption** ([Guide/IncrementalAdoption.md](Guide/IncrementalAdoption.md)): Learn how you can introduce Swift concurrency features into your project |
| 12 | - **Migrating to upcoming language features** ([Guide/FeatureMigration.md](Guide/FeatureMigration.md)): Migrate your project to upcoming language features. |
| 13 | - **Source Compatibility** ([Guide/SourceCompatibility.md](Guide/SourceCompatibility.md)): See an overview of potential source compatibility issues. |
| 14 | - **Library Evolution** ([Guide/LibraryEvolution.md](Guide/LibraryEvolution.md)): Annotate library APIs for concurrency while preserving source and ABI |
| 15 | - **Runtime Behavior** ([Guide/RuntimeBehavior.md](Guide/RuntimeBehavior.md)): Learn how Swift concurrency runtime semantics differ from other runtimes you may |
| 16 | |
| 17 | ## Code Examples |
| 18 | |
| 19 | Swift source files demonstrating migration patterns and concurrency concepts: |
| 20 | |
| 21 | - **Boundaries.swift** ([Examples/Boundaries.swift](Examples/Boundaries.swift)): Example code demonstrating Boundaries. |
| 22 | - **ConformanceMismatches.swift** ([Examples/ConformanceMismatches.swift](Examples/ConformanceMismatches.swift)): Example code demonstrating ConformanceMismatches. |
| 23 | - **DispatchQueue_PendingWork.swift** ([Examples/DispatchQueue_PendingWork.swift](Examples/DispatchQueue_PendingWork.swift)): Example code demonstrating DispatchQueue PendingWork. |
| 24 | - **Globals.swift** ([Examples/Globals.swift](Examples/Globals.swift)): Example code demonstrating Globals. |
| 25 | - **IncrementalMigration.swift** ([Examples/IncrementalMigration.swift](Examples/IncrementalMigration.swift)): Example code demonstrating IncrementalMigration. |
| 26 | - **PreconcurrencyImport.swift** ([Examples/PreconcurrencyImport.swift](Examples/PreconcurrencyImport.swift)): Example code demonstrating PreconcurrencyImport. |
| 27 | - **main.swift** ([Examples/main.swift](Examples/main.swift)): Example code demonstrating main. |
| 28 | |
| 29 | ## Usage Notes |
| 30 | |
| 31 | - Start with Data Race Safety to understand the core concepts |
| 32 | - Follow the Migration Strategy for a recommended approach |
| 33 | - Refer to Common Problems for solutions to typical issues |
| 34 | - Use the Code Examples as reference implementations |
| 35 | |
| 36 | ## License & Attribution |
| 37 | |
| 38 | ### Content License |
| 39 | |
| 40 | The documentation and example code in this skill are from the [Swift Concurrency Migration Guide](https://github.com/swiftlang/swift-migration-guide.git), copyright Apple Inc. and the Swift project authors, distributed under the [Apache 2.0 License](LICENSE.txt). |
| 41 | |
| 42 | ### Skill Structure License |
| 43 | |
| 44 | The structure and organization of this skill (this index file) is copyright Kyle Hughes, distributed under the MIT License. |