swift-concurrency

• Teams migrating to Swift 6 / strict concurrency who need safe defaults and quick triage.
• Developers debugging data races, isolation errors, or flaky async tests.
• Anyone wanting performance-minded concurrency patterns (actors, tasks, Sendable, async streams).

Option A: Using skills.sh (recommended)

Install this skill with a single command:

```bash

npx skills add https://github.com/avdlee/swift-concurrency-agent-skill --skill swift-concurrency

```

For more information, visit the [skills.sh platform page](https://skills.sh/avdlee/swift-concurrency-agent-skill/swift-concurrency).

Then use the skill in your AI agent, for example:

> Use the swift concurrency skill and analyze the current project for Swift Concurrency improvements

Option B: Claude Code Plugin

#### Personal Usage

To install this Skill for your personal use in Claude Code:

1. Add the marketplace:

```bash

/plugin marketplace add AvdLee/Swift-Concurrency-Agent-Skill

```

1. Install the Skill:

```bash

/plugin install swift-concurrency@swift-concurrency-agent-skill

```

#### Project Configuration

To automatically provide this Skill to everyone working in a repository, configure the repository's .claude/settings.json:

```json

{

"enabledPlugins": {

"swift-concurrency@swift-concurrency-agent-skill": true

},

"extraKnownMarketplaces": {

"swift-concurrency-agent-skill": {

"source": {

"source": "github",

"repo": "AvdLee/Swift-Concurrency-Agent-Skill"

}

}

}

}

```

When team members open the project, Claude Code will prompt them to install the Skill.

Option C: Manual install

1) Clone this repository.

2) Install or symlink the swift-concurrency/ folder following your tool’s official skills installation docs (see links below).

3) Use your AI tool as usual and ask it to use the “swift-concurrency” skill for Swift Concurrency tasks.

#### Where to Save Skills

Follow your tool’s official documentation, here are a few popular ones:

• Codex: [Where to save skills](https://developers.openai.com/codex/skills/#where-to-save-skills)
• Claude: [Using Skills](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview#using-skills)
• Cursor: [Enabling Skills](https://cursor.com/docs/context/skills#enabling-skills)

How to verify:

Your agent should reference the triage/playbook in swift-concurrency/SKILL.md and jump into the relevant reference file for your error or task.

This skill gives your AI coding tool comprehensive Swift Concurrency guidance. It can:

Guide Your Concurrency Decisions

• Choose the right tool for the job (async/await, actors, tasks, task groups)
• Understand when to use @MainActor, custom actors, or nonisolated
• Navigate isolation domains and prevent data races at compile time
• Apply Sendable conformance correctly for value and reference types

Write Safe Concurrent Code

• Avoid common pitfalls like actor reentrancy and retain cycles
• Prevent data races with proper isolation
• Handle task cancellation and error propagation correctly
• Manage memory safely in concurrent contexts

Optimize Performance

• Choose between serialized, asynchr