agent-skills

Apple BackgroundTasks framework for iOS/iPadOS background processing. Use when scheduling background work, refreshing app content, running long processing tasks, implementing BGAppRefreshTask, BGProcessingTask, BGContinuedProcessingTask, or dealing with BGTaskScheduler setup, registration, submission, expiration handlers, and debugger testing commands.

Expert guidance on Swift Concurrency best practices, patterns, and implementation. Use when developers mention: (1) Swift Concurrency, async/await, actors, or tasks, (2) "use Swift Concurrency" or "modern concurrency patterns", (3) migrating to Swift 6, (4) data races or thread safety issues, (5) refactoring closures to async/await, (6) @MainActor, Sendable, or actor isolation, (7) concurrent code architecture or performance optimization, (8) concurrency-related linter warnings (SwiftLint or similar; e.g. async_without_await, Sendable/actor isolation/MainActor lint).

Build type-safe Swift state machines with enum states and action-based transitions. Use for lifecycle or protocol flows, reentrancy-sensitive operations, or async/concurrent workflows.

Type-driven domain modeling techniques for Swift using proper domain types, validation-carrying types, witness-based access control, and illegal-state elimination. Use when designing domain models, replacing primitive obsession, modeling workflows with enums/structs, adding compile-time guarantees, or discussing parse-dont-validate and making illegal states unrepresentable.

AccessorySetupKit for privacy-preserving discovery and setup of Bluetooth, Wi-Fi, or Wi-Fi Aware accessories. Use for discovery sessions, picker-based authorization, migration, accessory renaming or removal, custom filtering, and required Info.plist declarations.

Functional architecture guidance for Swift (immutability, pure functions, reducers, DI via functions).

Step-by-step guidance for maintaining a linear Git workflow using rebases, feature branches, and fast-forward merges.

Patterns and best practices for building robust AsyncStream and AsyncSequence types, learned from swift-async-algorithms.

Apple Core Bluetooth framework for BLE and Bluetooth Classic. Use for central/peripheral workflows, scanning, connecting, advertising, GATT services/characteristics, read/write/notify, L2CAP, background processing or state restoration, and error handling across Apple platforms.

Apple HealthKit framework for health and fitness data. Use for reading/writing health samples, workout data, authorization flows, observer queries, background delivery, clinical records, activity rings, and integrating with the Health app across iPhone, Apple Watch, iPad, and visionOS.

Apple Observation framework for Swift. Use when modeling observable state with the `@Observable` macro, tracking changes with `withObservationTracking`, integrating with SwiftUI, or working with ObservationRegistrar and Observations async sequences.

Swift Package Manager documentation - create packages, manage dependencies, build and test Swift code

Provides the complete Embedded Swift documentation for developing on microcontrollers, embedded systems, and baremetal applications.

The complete Swift Programming Language book by Apple, covering syntax, features, concurrency, and the formal language reference.

Algorithms for working with AsyncSequence: combining, throttling, debouncing, chunking, and more

The Composable Architecture (TCA) - A library for building Swift applications with state management, composition, and testability

A dependency management library for Swift with controlled, testable dependencies

Official Swift DocC documentation markup and syntax reference

AppKit navigation tools: bindings, animations, and macOS navigation patterns

A collection of tools for making navigation in Swift applications more ergonomic and powerful across SwiftUI, UIKit, and AppKit

Core navigation primitives for Swift: AlertState, ConfirmationDialogState, UIBinding, and observation tools

SwiftUI navigation tools: type-safe alerts, sheets, popovers, and navigation destinations

UIKit navigation tools: bindings, animations, and navigation stack management

A library for sharing state across your app with persistence and observation support

A library for snapshot testing in Swift with support for views, images, and custom formats