Index of every page on this site: llms.txt
All skills
rshankras avatar

/concurrency-patterns

@f958982
Run it yourself

Swift concurrency patterns including Swift 6.2 approachable concurrency, structured concurrency, actors, continuations, and migration. Use when reviewing or building async code, fixing data race errors, or migrating to Swift 6.

Use this Skill: https://skilld.dev/gh/rshankras/claude-code-apple-skills/concurrency-patterns

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈62 tokens for metadata: the name and description. ≈1.4k when used: this file. ≈22k more on demand in 6 files.

Description uses 3.1% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈250 characters, or 3.1%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Swift Concurrency Patterns

Comprehensive guide for Swift concurrency covering async/await, structured concurrency, actors, and the Swift 6.2 "Approachable Concurrency" features. Focuses on patterns that prevent data races and common mistakes that cause crashes.

When This Skill Activates

  • User has data race errors or actor isolation compiler errors
  • User is migrating to Swift 6 strict concurrency
  • User asks about async/await, actors, Sendable, TaskGroup, or MainActor
  • User needs to bridge legacy completion-handler APIs to async/await
  • User is working with Swift 6.2 features (@concurrent, isolated conformances)
  • User has concurrency bugs (actor reentrancy, task cancellation, UI freezes)

Decision Tree

What concurrency problem are you solving?
│
├─ Swift 6 compiler errors / migration
│  └─ migration-guide.md
│
├─ Swift 6.2 new features (@concurrent, isolated conformances)
│  └─ swift62-concurrency.md
│
├─ Running work in parallel (async let, TaskGroup)
│  └─ structured-concurrency.md
│
├─ Thread safety for shared mutable state
│  └─ actors-and-isolation.md
│
├─ Bridging old APIs (delegates, callbacks) to async/await
│  └─ continuations-bridging.md
│
├─ Hangs, slow parallelism, thread-pool problems, profiling
│  └─ concurrency-internals.md
│
└─ General async/await patterns
   └─ See macos/coding-best-practices/modern-concurrency.md for basics

Quick Reference

Pattern When to Use Reference
async let Fixed number of parallel operations structured-concurrency.md
withTaskGroup Dynamic number of parallel operations structured-concurrency.md
withDiscardingTaskGroup Fire-and-forget parallel operations structured-concurrency.md
.task { } modifier Load data when view appears structured-concurrency.md
.task(id:) modifier Re-load when a value changes structured-concurrency.md
actor Shared mutable state protection actors-and-isolation.md
@MainActor UI-bound state and updates actors-and-isolation.md
@concurrent Explicitly offload to background (6.2) swift62-concurrency.md
Isolated conformances @MainActor type conforming to protocol (6.2) swift62-concurrency.md
withCheckedContinuation Bridge callback API to async continuations-bridging.md
AsyncStream Bridge delegate/notification API to async sequence continuations-bridging.md
@TaskLocal Context (IDs, tracing) down the task tree structured-concurrency.md
Atomic / Mutex Sendable wrappers for synchronous hot paths (Swift 6) actors-and-isolation.md
Custom actor executors Bridge existing DispatchSerialQueue synchronization concurrency-internals.md
Swift Concurrency Instrument Diagnose hangs, actor contention, continuation leaks concurrency-internals.md
Strict concurrency migration Incremental Swift 6 adoption migration-guide.md

Process

1. Identify the Problem

Read the user's code or error messages to determine:

  • Is this a compiler error (strict concurrency) or a runtime issue (data race, crash)?
  • What Swift version and concurrency checking level are they using?
  • Are they migrating existing code or writing new code?

2. Load Relevant Reference Files

Based on the problem, read from this directory:

  • swift62-concurrency.md — Swift 6.2 approachable concurrency features, Apple's adoption doctrine, Swift 6.3/6.4 additions
  • structured-concurrency.md — async let, TaskGroup, .task modifier lifecycle, task-locals, cancellation semantics
  • actors-and-isolation.md — Actor patterns, reentrancy, @MainActor, Sendable, Atomic/Mutex
  • concurrency-internals.md — cooperative pool, unsafe primitives, actor scheduling, Swift Concurrency Instrument
  • continuations-bridging.md — withCheckedContinuation, AsyncStream, built-in async sequences, legacy bridging
  • migration-guide.md — Incremental Swift 6 strict concurrency adoption (WWDC24 doctrine)

3. Review Checklist

  • No blocking calls on @MainActor (use await for long operations)
  • Shared mutable state protected by an actor (not locks or DispatchQueue)
  • Sendable conformance correct for types crossing isolation boundaries
  • Task cancellation handled (check Task.isCancelled or Task.checkCancellation())
  • No unstructured Task {} where structured concurrency (.task, TaskGroup) would work
  • Actor reentrancy considered at suspension points
  • withCheckedContinuation called exactly once (not zero, not twice)
  • .task(id:) used instead of manual onChange + cancel patterns

4. Cross-Reference

  • For async/await basics and actor fundamentals, see macos/coding-best-practices/modern-concurrency.md
  • For networking concurrency patterns, see generators/networking-layer/networking-patterns.md
  • For SwiftData concurrency (@ModelActor), see macos/swiftdata-architecture/repository-pattern.md
  • For auth token refresh with actors, see generators/auth-flow/auth-patterns.md

References

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts3mo3 checks · Risk SAFE
  • Gen Agent Trust Hub3mo

    This skill provides educational content and decision-making patterns for Swift concurrency. It is functionally safe but possesses a potential surface for indirect prompt injection when analyzing external code, and contains a local absolute file path in its documentation.

  • Socket3mo

    No alerts

  • Snyk3mo

    Risk: LOW · No issues

Signed by skilld at f958982. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last week.

Activeupdated 4 months ago
What it can do
Reads files
last_verified
2026-07-16
review_by
2027-06-22
os_version
iOS 27 / macOS 27
All 3 allowed tools
ReadGlobGrep

README badge

README badge for rshankras/claude-code-apple-skills/concurrency-patterns