This project provides expert Swift Concurrency guidance as an "Agent Skill" for AI coding tools, targeting developers and teams migrating to Swift 6 or optimizing concurrent code. It distills complex concurrency concepts into actionable references, enabling AI assistants to offer safe defaults, quick triage for concurrency issues, and performance-minded patterns.

How It Works

This skill is a curated collection of expert knowledge, derived from real-world Swift 6 migrations and the comprehensive Swift Concurrency Course. It's structured in the Agent Skills open format, comprising a main SKILL.md file with decision trees and numerous detailed Markdown references covering specific topics like actors, tasks, Sendable, async streams, and migration strategies. AI agents can leverage these references to analyze code, debug concurrency errors, and suggest best practices.

Quick Start & Requirements

The recommended installation uses the openskills CLI:

1. Install OpenSkills: npm i -g openskills
2. Navigate to your project directory.
3. Install the skill: openskills install avdlee/Swift-Concurrency-Agent-Skill
4. Sync the skill: openskills sync An alternative manual installation involves cloning the repository and linking the skill folder per your AI tool's documentation. This skill requires an AI coding tool that supports the Agent Skills open format.

Highlighted Details

• Expert Knowledge: Distilled from extensive real-world Swift 6 migration experience and a dedicated Swift Concurrency Course.
• Swift 6.2 Ready: Covers the latest features including Default Actor Isolation, isolated deinit, Global Actor Conformance, nonisolated(nonsending), @concurrent, and Approachable Concurrency build settings.
• Comprehensive Coverage: Addresses concurrency decisions, safe code writing (data races, cancellation, memory management), performance optimization, Swift 6 migration strategies, concurrent code testing, and Core Data integration.
• Actionable Guidance: Provides practical advice with code examples, focusing on industry-standard best practices and compile-time safety.

Maintenance & Community

Maintained by Antoine van der Lee, a recognized Swift Concurrency expert and creator of the Swift Concurrency Course. The skill is designed to evolve with the Swift language, reflecting the latest best practices. Contributions via Pull Requests are welcomed.

Licensing & Compatibility

This skill is released under the permissive MIT License, allowing for broad adoption, including in commercial and closed-source projects without significant restrictions.

Limitations & Caveats

This is an "Agent Skill" and not a standalone tool; its effectiveness is contingent upon the AI coding tool's ability to interpret and apply the provided guidance. The skill relies on the AI agent's intelligence and the user's context for accurate implementation.