@mmerterden/multi-agent-pipeline 20.8.0 → 20.8.2

package/pipeline/skills/shared/README.md

@@ -95,27 +95,27 @@ Source layout is logical grouping only  -  skill discovery at runtime is unchang
 | Skill | Group | Description |
 |-------|-------|-------------|
 | [`accessibility-compliance-accessibility-audit`](./external/accessibility-compliance-accessibility-audit/) | `external` | WCAG 2.2 AA audit process for web, iOS and Android: scope, automated scans, screen-reader and keyboard checks, severity, report, retest. Use |
-| [`alarmkit`](./external/alarmkit/) | `external` | AlarmKit alarms and countdown timers on iOS and iPadOS 26: AlarmManager scheduling and authorization, AlarmAttributes, AlarmPresentation and |
-| [`app-clips`](./external/app-clips/) | `external` | Build and review iOS App Clips: target setup and entitlements, invocation URLs from NFC tags, App Clip Codes, QR codes, Messages, Maps and S |
-| [`app-intents`](./external/app-intents/) | `external` | Exposing iOS app actions and data to Siri, the Shortcuts app, Spotlight search, widgets, Control Center controls and Apple Intelligence with |
+| [`alarmkit`](./external/alarmkit/) | `external` | AlarmKit alarms and countdown timers on iOS and iPadOS 26: AlarmManager scheduling and authorization, AlarmAttributes, AlarmPresentation, Al |
+| [`app-clips`](./external/app-clips/) | `external` | iOS App Clips: target setup, invocation from NFC, App Clip Codes, QR, Messages, Maps and Safari banners, App Store Connect experiences, size |
+| [`app-intents`](./external/app-intents/) | `external` | App Intents for Siri, Shortcuts, Spotlight, widgets, Control Center and Apple Intelligence: AppIntent actions, AppEntity and EntityQuery, Ap |
 | [`app-store-changelog`](./external/app-store-changelog/) | `external` | Generate user-facing App Store release notes from git history since the last tag. Use when release notes have to be written from the commits |
-| [`app-store-optimization`](./external/app-store-optimization/) | `external` | App Store Optimization (ASO) for ranking and conversion: keyword research; what to put in the app name, subtitle and 100-byte keyword field; |
+| [`app-store-optimization`](./external/app-store-optimization/) | `external` | App Store Optimization (ASO) for ranking and conversion: keyword research; app name, subtitle and 100-byte keyword field; description and pr |
 | [`app-store-review`](./external/app-store-review/) | `external` | App Store submission readiness and rejection prevention: Review Guidelines 2.1, 2.3, 2.5.1, 3.1.1, 4.2 and 5.1.2, PrivacyInfo.xcprivacy mani |
-| [`apple-on-device-ai`](./external/apple-on-device-ai/) | `external` | Local AI on Apple hardware: the Foundation Models framework (SystemLanguageModel, LanguageModelSession, @Generable and @Guide typed output,  |
-| [`authentication`](./external/authentication/) | `external` | Build iOS sign-in with AuthenticationServices and LocalAuthentication: Sign in with Apple; passkeys (WebAuthn) for registering and logging i |
-| [`background-processing`](./external/background-processing/) | `external` | Scheduling and running iOS background work with BGTaskScheduler: BGAppRefreshTask for short fetches, BGProcessingTask for long maintenance,  |
-| [`callkit-voip`](./external/callkit-voip/) | `external` | CallKit and PushKit VoIP calling on iOS: CXProvider and CXProviderConfiguration, CXCallController transactions, incoming and outgoing call f |
-| [`cloudkit-sync`](./external/cloudkit-sync/) | `external` | Implement, review or improve CloudKit and iCloud sync on iOS and macOS: CKContainer and its public, private and shared databases, CKRecord,  |
-| [`contacts-framework`](./external/contacts-framework/) | `external` | Reading, creating, updating, deleting and picking contacts with the Contacts and ContactsUI frameworks: CNContactStore authorization includi |
-| [`core-bluetooth`](./external/core-bluetooth/) | `external` | Direct Bluetooth Low Energy work with Core Bluetooth: central and peripheral GATT communication, scanning and connecting with CBCentralManag |
-| [`core-motion`](./external/core-motion/) | `external` | Read motion hardware with Core Motion on iOS and watchOS: accelerometer, gyroscope and magnetometer streams, fused device motion and attitud |
-| [`core-nfc`](./external/core-nfc/) | `external` | Core NFC on iPhone: reading and writing NFC tags, scanning NDEF tags, native access to ISO7816, ISO15693, FeliCa and MIFARE tags, writing ND |
-| [`coreml`](./external/coreml/) | `external` | Swift-side Core ML integration for on-device inference: loading .mlmodel, .mlpackage and .mlmodelc models, predictions through Xcode-generat |
-| [`device-integrity`](./external/device-integrity/) | `external` | Prove that server traffic comes from a real Apple device running your untampered app, using DeviceCheck (DCDevice tokens and the two bits Ap |
-| [`energykit`](./external/energykit/) | `external` | Use EnergyKit on iOS and iPadOS 26 to read grid electricity forecasts, submit load events and help people use home electricity when the grid |
-| [`eventkit-calendar`](./external/eventkit-calendar/) | `external` | EventKit and EventKitUI for the user's calendars and reminders: putting events on a calendar, making reminders, repeat rules, asking for cal |
+| [`apple-on-device-ai`](./external/apple-on-device-ai/) | `external` | On-device AI on Apple hardware: Foundation Models (SystemLanguageModel, LanguageModelSession, @Generable and @Guide structured output, tool  |
+| [`authentication`](./external/authentication/) | `external` | iOS sign-in with AuthenticationServices and LocalAuthentication: Sign in with Apple, passkey (WebAuthn) sign-up and login via ASAuthorizatio |
+| [`background-processing`](./external/background-processing/) | `external` | iOS background work with BGTaskScheduler: BGAppRefreshTask short fetches, BGProcessingTask long maintenance, BGContinuedProcessingTask (iOS  |
+| [`callkit-voip`](./external/callkit-voip/) | `external` | CallKit and PushKit VoIP calling: CXProvider and CXCallController, incoming and outgoing call flows, call actions, VoIP push registration an |
+| [`cloudkit-sync`](./external/cloudkit-sync/) | `external` | CloudKit and iCloud sync on iOS and macOS: CKContainer public, private and shared databases, CKRecord, CKQuery, CKSubscription, CKSyncEngine |
+| [`contacts-framework`](./external/contacts-framework/) | `external` | Contacts and ContactsUI: CNContactStore authorization and limited access, fetch and save requests, creating, updating and deleting contacts, |
+| [`core-bluetooth`](./external/core-bluetooth/) | `external` | Direct BLE with Core Bluetooth: central and peripheral GATT communication, CBCentralManager scanning and connecting, service and characteris |
+| [`core-motion`](./external/core-motion/) | `external` | Core Motion on iOS and watchOS: accelerometer, gyroscope, magnetometer, fused device motion and reference frames, CMPedometer steps, distanc |
+| [`core-nfc`](./external/core-nfc/) | `external` | Core NFC on iPhone: reading and writing NDEF tags, ISO7816, ISO15693, FeliCa and MIFARE access, reader session lifecycle, NFC entitlement an |
+| [`coreml`](./external/coreml/) | `external` | Swift-side Core ML: loading .mlmodel, .mlpackage and .mlmodelc, predictions via generated classes and MLFeatureProvider, compute units, asyn |
+| [`device-integrity`](./external/device-integrity/) | `external` | DeviceCheck and App Attest: DCDevice tokens and per-device bits, DCAppAttestService key generation, attestation and assertions. Use when add |
+| [`energykit`](./external/energykit/) | `external` | EnergyKit on iOS 26: grid electricity forecasts via ElectricityGuidance, EnergyVenue, EV and HVAC load events, ElectricityInsightService his |
+| [`eventkit-calendar`](./external/eventkit-calendar/) | `external` | EventKit and EventKitUI: adding events to the user's calendar, creating reminders, recurrence rules, calendar or reminders access, event edi |
 | [`firebase`](./external/firebase/) | `external` | You're a developer who has shipped dozens of Firebase projects. You've seen the easy path lead to security breaches, runaway costs, and impo |
-| [`healthkit`](./external/healthkit/) | `external` | Apple Health data through HealthKit on iOS, iPadOS, watchOS and visionOS: HKHealthStore permission requests, sample, statistics and chart-re |
+| [`healthkit`](./external/healthkit/) | `external` | HealthKit on iOS, iPadOS, watchOS and visionOS: HKHealthStore authorization, sample, statistics and chart-ready collection queries, saving H |
 | [`hig-components-content`](./external/hig-components-content/) | `external` | Apple HIG for content views mapped to SwiftUI: lists, tables, grids, charts, images, text, web views, empty states. Use when choosing or rev |
 | [`hig-components-layout`](./external/hig-components-layout/) | `external` | Apple HIG for app structure mapped to SwiftUI: tab bars, split views, navigation stacks, toolbars, sheets, popovers, alerts, windows, iOS 26 |
 | [`hig-components-status`](./external/hig-components-status/) | `external` | Apple HIG for status UI mapped to SwiftUI: progress views, gauges, placeholders, status bar, activity rings, success and failure feedback. U |
@@ -125,64 +125,64 @@ Source layout is logical grouping only  -  skill discovery at runtime is unchang
 | [`hig-patterns`](./external/hig-patterns/) | `external` | Apple HIG interaction patterns mapped to SwiftUI: modality, loading, empty and error states, feedback, undo, search, data entry, settings, s |
 | [`hig-platforms`](./external/hig-platforms/) | `external` | Apple HIG per platform: iPhone, iPad, Mac, Watch, TV and Vision Pro conventions, and adapting one SwiftUI codebase across them. Use when a d |
 | [`hig-technologies`](./external/hig-technologies/) | `external` | Apple HIG for system technologies: Sign in with Apple, passkeys, Apple Pay, Wallet, Siri and App Intents, HealthKit, HomeKit, iCloud, Maps,  |
-| [`homekit-matter`](./external/homekit-matter/) | `external` | Smart-home development with HomeKit and MatterSupport: managing homes, rooms, zones and accessories, reading, writing and observing accessor |
-| [`ios-accessibility`](./external/ios-accessibility/) | `external` | Accessibility for iOS, iPadOS and macOS apps in SwiftUI, UIKit and AppKit: support for VoiceOver, Switch Control, Full Keyboard Access and V |
+| [`homekit-matter`](./external/homekit-matter/) | `external` | HomeKit and MatterSupport: managing homes, rooms, zones and accessories, reading characteristics, action sets and triggers, Matter commissio |
+| [`ios-accessibility`](./external/ios-accessibility/) | `external` | VoiceOver, Voice Control, Switch Control and Full Keyboard Access in SwiftUI, UIKit and AppKit on iOS, iPadOS and macOS: labels, hints, valu |
 | [`ios-coding-standard`](./external/ios-coding-standard/) | `external` | The iOS coding-standard rule registry: 99 stable-ID rules across readability, security, service layer, business rules, concurrency, testing, |
 | [`ios-debugger-agent`](./external/ios-debugger-agent/) | `external` | Debug the current iOS project on a booted simulator with XcodeBuildMCP. Use when an iOS bug has to be reproduced and diagnosed on a booted s |
-| [`ios-localization`](./external/ios-localization/) | `external` | Internationalization and localization for iOS and macOS apps: String Catalogs (.xcstrings), generated localizable symbols with compile-time- |
+| [`ios-localization`](./external/ios-localization/) | `external` | i18n and l10n for iOS and macOS: String Catalogs (.xcstrings), generated localizable symbols with compile-time-checked keys, stable key nami |
 | [`ios-module-structure`](./external/ios-module-structure/) | `external` | The ios-module-structure rule registry: stable-ID rules over where a declaration lives, what its file is called and what its folder must con |
-| [`ios-networking`](./external/ios-networking/) | `external` | Networking on iOS and macOS built on URLSession, async/await and structured concurrency: HTTP requests, REST API clients, response validatio |
+| [`ios-networking`](./external/ios-networking/) | `external` | URLSession with async/await and structured concurrency on iOS and macOS: HTTP requests, REST API clients, response validation, error handlin |
 | [`ios-security`](./external/ios-security/) | `external` | Secure iOS apps with Keychain Services, CryptoKit encryption, biometric authentication (Face ID, Touch ID), Secure Enclave key storage, LACo |
-| [`ios-simulator`](./external/ios-simulator/) | `external` | Drive the iOS Simulator from the command line with xcrun simctl: create, boot, erase and delete devices, install and launch apps, simulate p |
-| [`live-activities`](./external/live-activities/) | `external` | ActivityKit Live Activities for Lock Screen and Dynamic Island: ActivityAttributes and ContentState, request/update/end lifecycle, compact/m |
+| [`ios-simulator`](./external/ios-simulator/) | `external` | xcrun simctl from the command line: create, boot, erase and delete devices, install and launch apps, simulated pushes without APNs, GPS loca |
+| [`live-activities`](./external/live-activities/) | `external` | ActivityKit Live Activities on the Lock Screen and Dynamic Island: ActivityAttributes and ContentState, request/update/end lifecycle, compac |
 | [`macos-menubar-tuist-app`](./external/macos-menubar-tuist-app/) | `external` | Build, refactor, or review SwiftUI macOS menubar apps that use Tuist. Use when building, refactoring or reviewing a SwiftUI macOS menubar ap |
 | [`macos-spm-app-packaging`](./external/macos-spm-app-packaging/) | `external` | Scaffold, build, sign, and package SwiftPM macOS apps without Xcode projects. Use when a SwiftPM macOS app has to be built, signed or packag |
-| [`mapkit-location`](./external/mapkit-location/) | `external` | Maps and location in Swift apps for iOS and macOS with MapKit and CoreLocation: SwiftUI Map views, markers, annotations, polylines and other |
-| [`metrickit-diagnostics`](./external/metrickit-diagnostics/) | `external` | Field performance data and crash diagnostics from shipping apps via MetricKit: registering an MXMetricManager subscriber, handling MXMetricP |
-| [`musickit-audio`](./external/musickit-audio/) | `external` | Apple Music and system audio integration on iOS with MusicKit and MediaPlayer: MusicAuthorization, catalog search, MusicSubscription checks  |
-| [`natural-language`](./external/natural-language/) | `external` | On-device text analysis with the NaturalLanguage framework and in-app translation with the Translation framework: tokenizing, language ident |
-| [`passkit-wallet`](./external/passkit-wallet/) | `external` | PassKit for Apple Pay checkout and Wallet passes: Apple Pay buttons, building payment requests, the payment authorization flow, merchant cap |
-| [`pencilkit-drawing`](./external/pencilkit-drawing/) | `external` | Apple Pencil and finger drawing with PencilKit: PKCanvasView canvases and drawing policies, PKToolPicker palettes including custom items, PK |
-| [`permissionkit`](./external/permissionkit/) | `external` | PermissionKit parent and guardian approval for minors: CommunicationLimits known-handle checks, CommunicationHandle kinds, PermissionQuestio |
-| [`photos-camera-media`](./external/photos-camera-media/) | `external` | Choosing photos, capturing with the camera, and handling media on iOS with PhotoKit and AVFoundation: PhotosPicker and PHPickerViewControlle |
-| [`push-notifications`](./external/push-notifications/) | `external` | Notifications on iOS and macOS, both device-scheduled and server-sent, using UserNotifications and APNs: permission (standard, provisional,  |
-| [`realitykit-ar`](./external/realitykit-ar/) | `external` | RealityKit and ARKit on iOS: RealityView with RealityViewCameraContent, AR camera availability and permission, entities and components, USDZ |
-| [`shareplay-activities`](./external/shareplay-activities/) | `external` | GroupActivities and SharePlay on iOS, macOS, tvOS and visionOS: Group Activities capability, eligibility checks, GroupActivity and metadata, |
-| [`speech-recognition`](./external/speech-recognition/) | `external` | Speech-to-text with Apple's Speech framework: live microphone transcription through AVAudioEngine, transcribing recorded audio files, permis |
-| [`storekit`](./external/storekit/) | `external` | In-app purchases and subscriptions with StoreKit 2 in Swift: paywalls built with SubscriptionStoreView, StoreView or ProductView, purchase f |
-| [`swift-api-design-guidelines`](./external/swift-api-design-guidelines/) | `external` | Swift API Design Guidelines applied to real declarations: clarity at the call site over brevity, argument labels and prepositions, method ve |
-| [`swift-architecture`](./external/swift-architecture/) | `external` | App architecture on Apple platforms with Swift 6.3, SwiftUI and UIKit: choosing between MV with @Observable, MVVM, MVI, TCA, Clean Architect |
-| [`swift-charts`](./external/swift-charts/) | `external` | Building and reviewing data visualisations with Swift Charts: bar, line, area, point, pie and donut charts; 3D charts on iOS 26; axes, scale |
-| [`swift-codable`](./external/swift-codable/) | `external` | Codable models for JSON and property-list encoding and decoding in Swift: JSONDecoder, JSONEncoder, CodingKeys, custom init(from:) and encod |
-| [`swift-concurrency`](./external/swift-concurrency/) | `external` | Swift concurrency reference for Swift 6.2 and later: actor isolation, Sendable and sending, approachable concurrency (SE-0466 default MainAc |
+| [`mapkit-location`](./external/mapkit-location/) | `external` | MapKit and CoreLocation on iOS and macOS: SwiftUI Map, markers, annotations, polylines and overlays, camera control, user location tracking, |
+| [`metrickit-diagnostics`](./external/metrickit-diagnostics/) | `external` | MetricKit field telemetry from shipping apps: MXMetricManager subscribers, MXMetricPayload and MXDiagnosticPayload, crash, hang and disk-wri |
+| [`musickit-audio`](./external/musickit-audio/) | `external` | MusicKit and MediaPlayer on iOS: Apple Music authorization, catalog search, subscription checks and offers, ApplicationMusicPlayer playback  |
+| [`natural-language`](./external/natural-language/) | `external` | NaturalLanguage and Translation frameworks: tokenizing, language identification, part-of-speech tagging, named entities, sentiment, word and |
+| [`passkit-wallet`](./external/passkit-wallet/) | `external` | Apple Pay and Wallet passes with PassKit: Apple Pay buttons, payment requests, authorization flow, merchant capabilities, shipping and conta |
+| [`pencilkit-drawing`](./external/pencilkit-drawing/) | `external` | PencilKit drawing with Apple Pencil or finger: PKCanvasView, PKToolPicker and custom items, PKDrawing persistence and export, stroke inspect |
+| [`permissionkit`](./external/permissionkit/) | `external` | PermissionKit parental approval for minors: CommunicationLimits handle checks, PermissionQuestion, AskCenter requests and responses, Permiss |
+| [`photos-camera-media`](./external/photos-camera-media/) | `external` | PhotoKit and AVFoundation media on iOS: PhotosPicker and PHPickerViewController, Transferable loading of images, movies and Live Photos, pho |
+| [`push-notifications`](./external/push-notifications/) | `external` | UserNotifications and APNs on iOS and macOS, local and remote: permission (standard, provisional, critical), device-token registration, trig |
+| [`realitykit-ar`](./external/realitykit-ar/) | `external` | RealityKit and ARKit on iOS: RealityView camera content, AR camera availability and permission, entities and components, USDZ loading, plane |
+| [`shareplay-activities`](./external/shareplay-activities/) | `external` | GroupActivities and SharePlay on iOS, macOS, tvOS and visionOS: GroupActivity, GroupSession lifecycle, messengers, playback sync, file trans |
+| [`speech-recognition`](./external/speech-recognition/) | `external` | Speech framework speech-to-text: live microphone transcription with AVAudioEngine, recorded audio files, speech and microphone permission, o |
+| [`storekit`](./external/storekit/) | `external` | StoreKit 2 in-app purchases and subscriptions: SubscriptionStoreView, StoreView and ProductView paywalls, consumable, non-consumable and aut |
+| [`swift-api-design-guidelines`](./external/swift-api-design-guidelines/) | `external` | Swift API Design Guidelines: call-site clarity over brevity, argument labels and prepositions, method versus property, side-effect naming, m |
+| [`swift-architecture`](./external/swift-architecture/) | `external` | App architecture on Apple platforms (Swift 6.3, SwiftUI, UIKit): MV with @Observable, MVVM, MVI, TCA, Clean Architecture, VIPER, Coordinator |
+| [`swift-charts`](./external/swift-charts/) | `external` | Swift Charts: bar, line, area, point, pie, donut, iOS 26 3D charts (Chart3D, SurfacePlot), axes, scales, legends, annotations, scrolling, se |
+| [`swift-codable`](./external/swift-codable/) | `external` | Codable JSON and property-list models: JSONDecoder, JSONEncoder, CodingKeys, custom init(from:)/encode(to:), nested containers, date, data a |
+| [`swift-concurrency`](./external/swift-concurrency/) | `external` | Swift 6.2+ concurrency: actor isolation, Sendable, sending, approachable concurrency (SE-0466 default MainActor, @concurrent, nonisolated(no |
 | [`swift-concurrency-expert`](./external/swift-concurrency-expert/) | `external` | Review and fix Swift concurrency issues such as actor isolation and Sendable violations. Use when a Swift concurrency problem needs diagnosi |
 | [`swift-concurrency-pro`](./external/swift-concurrency-pro/) | `external` | Reviews Swift code for concurrency correctness, modern API usage, and common async/await pitfalls. Use when reading, writing, or reviewing S |
-| [`swift-formatstyle`](./external/swift-formatstyle/) | `external` | Display formatting through FormatStyle and the styles Foundation ships: integers, floating point and decimals, currency amounts, percentages |
-| [`swift-language`](./external/swift-language/) | `external` | Core Swift 6.3 language work outside concurrency and SwiftUI: if and switch expressions, typed throws, result builders, property wrappers, s |
-| [`swift-security`](./external/swift-security/) | `external` | Apple-platform client security: Keychain Services (SecItem queries, kSecClass choice, OSStatus errors on iOS and macOS), Face ID and Touch I |
-| [`swift-testing`](./external/swift-testing/) | `external` | Writing, migrating and reviewing tests with the Swift Testing framework: @Test, @Suite, #expect, #require, confirmation, traits, withKnownIs |
+| [`swift-formatstyle`](./external/swift-formatstyle/) | `external` | Display formatting with FormatStyle (iOS 15+): integers, floating point, decimals, currency, percentages, dates, date ranges, relative and a |
+| [`swift-language`](./external/swift-language/) | `external` | Core Swift 6.3 outside concurrency and SwiftUI: if and switch expressions, typed throws, result builders, property wrappers, some vs any, gu |
+| [`swift-security`](./external/swift-security/) | `external` | Apple client security: Keychain (SecItem, kSecClass, OSStatus, iOS, macOS), Face ID/Touch ID keychain items, CryptoKit (AES-GCM, ChaChaPoly, |
+| [`swift-testing`](./external/swift-testing/) | `external` | Writing, migrating and reviewing Swift Testing tests: @Test, @Suite, #expect, #require, confirmation, traits, withKnownIssue, Attachment.rec |
 | [`swift-testing-pro`](./external/swift-testing-pro/) | `external` | Writes, reviews, and improves Swift Testing code using modern APIs and best practices. Use when reading, writing, or reviewing projects that |
 | [`swiftdata`](./external/swiftdata/) | `external` | SwiftData persistence for Apple apps: @Model classes with @Attribute, @Relationship, @Transient, #Unique and #Index; @Query, #Predicate, Fet |
 | [`swiftdata-pro`](./external/swiftdata-pro/) | `external` | Writes, reviews, and improves SwiftData code using modern APIs and best practices. Use when reading, writing, or reviewing projects that use |
-| [`swiftlint`](./external/swiftlint/) | `external` | Setting up and enforcing SwiftLint in Swift projects: SwiftLintBuildToolPlugin and the command plugin, Xcode run script phases, CI jobs, .sw |
-| [`swiftui-animation`](./external/swiftui-animation/) | `external` | SwiftUI motion: explicit withAnimation, scoped implicit .animation(_:body:) and .animation(_:value:), timing curves and springs (.smooth, .s |
+| [`swiftlint`](./external/swiftlint/) | `external` | SwiftLint setup and enforcement: build tool and command plugins, Xcode run scripts, CI, .swiftlint.yml rule sets (default, opt-in, analyzer) |
+| [`swiftui-animation`](./external/swiftui-animation/) | `external` | SwiftUI motion: withAnimation, scoped implicit .animation(_:body:) and .animation(_:value:), timing curves and springs (.smooth, .snappy, .b |
 | [`swiftui-expert-skill`](./external/swiftui-expert-skill/) | `external` | Write, review, or improve SwiftUI code following best practices for state management, view composition, performance, macOS-specific APIs, an |
-| [`swiftui-gestures`](./external/swiftui-gestures/) | `external` | SwiftUI gesture handling: tap, spatial tap, long press, drag, magnify and rotate gestures, composition with simultaneously, sequenced and ex |
-| [`swiftui-layout-components`](./external/swiftui-layout-components/) | `external` | SwiftUI layout and component patterns: VStack, HStack, ZStack and lazy stacks, LazyVGrid and LazyHGrid, List sections plus row swipe actions |
-| [`swiftui-liquid-glass`](./external/swiftui-liquid-glass/) | `external` | Liquid Glass in SwiftUI for iOS 26 and later: the glassEffect modifier, Glass variants with tint and interactive, GlassEffectContainer, glas |
-| [`swiftui-navigation`](./external/swiftui-navigation/) | `external` | SwiftUI navigation: NavigationStack with typed paths and navigationDestination, router objects for programmatic routing, NavigationSplitView |
-| [`swiftui-patterns`](./external/swiftui-patterns/) | `external` | Structure SwiftUI apps with the Model-View approach: who owns an @Observable object, when to use @State, @Bindable, let or @Environment, how |
-| [`swiftui-performance`](./external/swiftui-performance/) | `external` | Finding and fixing SwiftUI runtime performance problems: slow rendering, janky scrolling, high CPU or memory, views that update too often, l |
+| [`swiftui-gestures`](./external/swiftui-gestures/) | `external` | SwiftUI gestures: tap, spatial tap, long press, drag, magnify, rotate, composition (simultaneously, sequenced, exclusively), @GestureState,  |
+| [`swiftui-layout-components`](./external/swiftui-layout-components/) | `external` | SwiftUI layouts: stacks, lazy stacks, LazyVGrid/LazyHGrid, List sections, swipe actions, ScrollView with ScrollPosition, validated Form, Tog |
+| [`swiftui-liquid-glass`](./external/swiftui-liquid-glass/) | `external` | Liquid Glass in SwiftUI (iOS 26+): glassEffect, Glass tint/interactive variants, GlassEffectContainer, glassEffectID morphing, glassEffectUn |
+| [`swiftui-navigation`](./external/swiftui-navigation/) | `external` | SwiftUI navigation: NavigationStack typed paths, routers, NavigationSplitView, sheets, TabView and Tab API, universal links, URL schemes, Ha |
+| [`swiftui-patterns`](./external/swiftui-patterns/) | `external` | SwiftUI Model-View structure: @Observable ownership, @State, @Bindable, @Environment, view decomposition, custom ViewModifiers, .task loadin |
+| [`swiftui-performance`](./external/swiftui-performance/) | `external` | SwiftUI performance: slow rendering, janky scrolling, high CPU/memory, excess updates, layout thrash, costly body, identity churn, lazy load |
 | [`swiftui-performance-audit`](./external/swiftui-performance-audit/) | `external` | Audit SwiftUI performance issues from code review and profiling evidence. Use when a SwiftUI view is slow and the cause has to be found from |
 | [`swiftui-pro`](./external/swiftui-pro/) | `external` | Comprehensively reviews SwiftUI code for best practices on modern APIs, maintainability, and performance. Use when reading, writing, or revi |
 | [`swiftui-ui-patterns`](./external/swiftui-ui-patterns/) | `external` | Apply proven SwiftUI UI patterns for navigation, sheets, async state, and reusable screens. Use when a SwiftUI screen needs a proven pattern |
-| [`swiftui-uikit-interop`](./external/swiftui-uikit-interop/) | `external` | Connects UIKit and SwiftUI: UIViewRepresentable for a UIView, UIViewControllerRepresentable for a UIViewController, UIHostingController and  |
+| [`swiftui-uikit-interop`](./external/swiftui-uikit-interop/) | `external` | UIKit and SwiftUI interop: UIViewRepresentable, UIViewControllerRepresentable, UIHostingController, UIHostingConfiguration, Coordinator dele |
 | [`swiftui-view-refactor`](./external/swiftui-view-refactor/) | `external` | Refactor SwiftUI views into smaller components with stable, explicit data flow. Use when a SwiftUI view has grown too large and needs splitt |
-| [`swiftui-webkit`](./external/swiftui-webkit/) | `external` | Embedding and controlling web content in SwiftUI with the native WebKit for SwiftUI API: WebView and WebPage, observable title, URL and prog |
-| [`tipkit`](./external/tipkit/) | `external` | TipKit in-app tips for iOS 17+: Tips.configure, datastore location and CloudKit sync, the Tip protocol, TipView and popoverTip, TipViewStyle |
-| [`vision-framework`](./external/vision-framework/) | `external` | On-device computer vision with Apple's Vision and VisionKit frameworks: OCR text recognition, face detection and landmarks, barcode and QR s |
-| [`weatherkit`](./external/weatherkit/) | `external` | WeatherKit on iOS: WeatherService queries for current conditions, hourly, daily and minute forecasts, weather alerts, dataset availability a |
-| [`widgetkit`](./external/widgetkit/) | `external` | WidgetKit and ActivityKit surfaces on iOS 26+: timeline-driven widgets for the Home Screen, the Lock Screen and StandBy, interactive widgets |
+| [`swiftui-webkit`](./external/swiftui-webkit/) | `external` | Web content in SwiftUI with WebKit for SwiftUI: WebView, WebPage, observable page state, navigation policies, link interception, JavaScript  |
+| [`tipkit`](./external/tipkit/) | `external` | TipKit in-app tips (iOS 17+): Tip protocol, TipView, popoverTip, rules, events, TipGroup, styles, CloudKit sync. Use when building or review |
+| [`vision-framework`](./external/vision-framework/) | `external` | On-device computer vision with Vision and VisionKit: OCR, face detection and landmarks, barcode and QR scanning, person and instance segment |
+| [`weatherkit`](./external/weatherkit/) | `external` | WeatherKit on iOS: current, hourly, daily and minute forecasts, alerts, historical statistics, dataset selection, caching. Use when integrat |
+| [`widgetkit`](./external/widgetkit/) | `external` | WidgetKit surfaces on iOS 26+: timeline-driven widgets for the Home Screen, the Lock Screen and StandBy, interactive widgets using Button or |
 
 ## Android / Kotlin
 
@@ -242,22 +242,22 @@ Source layout is logical grouping only  -  skill discovery at runtime is unchang
 |-------|-------|-------------|
 | [`agent-introspection-debugging`](./external/agent-introspection-debugging/) | `external` | \| |
 | [`architecture`](./external/architecture/) | `external` | Stack-neutral architecture decisions: quality drivers, options with a trade-off matrix, reversibility, ADRs, fitness checks. Use when making |
-| [`avkit`](./external/avkit/) | `external` | AVKit media playback on iOS: AVPlayerViewController and SwiftUI VideoPlayer, Picture-in-Picture for standard and custom players, AirPlay rou |
+| [`avkit`](./external/avkit/) | `external` | AVKit playback UI: AVPlayerViewController, SwiftUI VideoPlayer, Picture-in-Picture, AirPlay routing, transport controls, subtitles and close |
 | [`backlog`](./external/backlog/) | `external` | Registry and routine for approved but postponed engineering work: each item keeps its full spec, origin and unblock condition, and moves thr |
 | [`ci-cd-pipelines`](./external/ci-cd-pipelines/) | `external` | CI/CD pipelines: GitHub Actions workflows, Docker multi-stage builds, environment management, secret management, deployment strategies. Use  |
 | [`clean-code`](./external/clean-code/) | `external` | Readability checks for code in any language: names, function focus, control flow, side effects, errors, comments, duplication. Use when writ |
 | [`context-compression`](./external/context-compression/) | `external` | Keeping long LLM agent sessions on track: what a summary must preserve, incremental structured summaries, state in files, compact versus res |
 | [`core-data`](./external/core-data/) | `external` | Create, audit or refine Core Data persistence for apps still on Core Data rather than SwiftData: stack setup, NSManagedObject subclasses, NS |
 | [`council`](./external/council/) | `external` | \| |
-| [`cryptokit`](./external/cryptokit/) | `external` | Apple CryptoKit primitives in Swift: SHA-2 and SHA-3 hashing, HMAC, AES-GCM and ChaChaPoly authenticated encryption, signatures with P256, P |
-| [`debugging-instruments`](./external/debugging-instruments/) | `external` | Debugging and profiling Apple-platform apps with Xcode tools: LLDB inspection, breakpoints, expressions and watchpoints; the Memory Graph De |
+| [`cryptokit`](./external/cryptokit/) | `external` | CryptoKit in Swift: SHA-2, SHA-3, HMAC, AES-GCM, ChaChaPoly, P256, P384, P521, Curve25519 and ML-DSA signatures, ECDH with HKDF, HPKE, ML-KE |
+| [`debugging-instruments`](./external/debugging-instruments/) | `external` | Xcode debugging and profiling: LLDB, Memory Graph Debugger, Instruments, crashes, leaks and retain cycles, main-thread hangs, slow rendering |
 | [`debugging-strategies`](./external/debugging-strategies/) | `external` | Language-neutral debugging method: reproduce, minimise, falsifiable hypotheses, git bisect, instrumentation, production traces, concurrency  |
 | [`evidence-github`](./external/evidence-github/) | `external` | Search GitHub for facts an analysis can cite - a known issue in a dependency, the PR that fixed it, what a release actually changed, prior a |
 | [`evidence-registry`](./external/evidence-registry/) | `external` | Check a package's real version, deprecation status and release notes on npm, PyPI, Maven Central or Swift Package Index. Use when a spec or  |
 | [`github-actions-templates`](./external/github-actions-templates/) | `external` | Authoring GitHub Actions workflows: triggers, matrices, caching, concurrency, least-privilege permissions, SHA pinning, OIDC, reusable workf |
 | [`humanizer`](./external/humanizer/) | `external` | \| |
 | [`localization-reuse-map`](./external/localization-reuse-map/) | `external` | Localization reuse map for one redesigned screen on iOS, Android and web: new keys set against each platform's legacy key, legacy values and |
-| [`pdfkit`](./external/pdfkit/) | `external` | PDFKit on iOS: showing PDFs in PDFView, creating and editing PDFDocument and PDFPage, annotations such as highlights, notes and signature or |
+| [`pdfkit`](./external/pdfkit/) | `external` | PDFKit on iOS: PDFView display and SwiftUI wrapping, creating and editing PDFDocument and PDFPage, highlight, note, signature and form annot |
 | [`search-first`](./external/search-first/) | `external` | \| |
 | [`security-review`](./external/security-review/) | `external` | Run a defensive, static security review of a diff or a repo: build a run-scoped threat model, find vulnerabilities joined to OWASP + CWE wit |
 | [`signal-community`](./external/signal-community/) | `external` | Check whether other people hit the same problem, via Stack Overflow and Hacker News (keyless) plus opt-in Reddit and X. Use when a bug repor |

package/pipeline/skills/shared/external/alarmkit/SKILL.md

@@ -389,7 +389,7 @@ Hand-offs:
   `WidgetCenter` reloads: `widgetkit`.
 - Non-alarm Live Activities (`Activity.request`, `update`, `end`),
   push-to-start and per-activity update tokens, and remote `content-state`
-  payloads: `activitykit`.
+  payloads: `live-activities`.
 - APNs, `UNUserNotificationCenter`, notification categories and actions,
   custom notification UI: `push-notifications`, unless the code ends up
   calling `AlarmManager`.
@@ -477,7 +477,7 @@ struct CoachWidgets: WidgetBundle {
 - [ ] AlarmKit is credited only with authorization, `AlarmManager` scheduling and state, attributes, presentation, presentation state, sound and system alarm actions
 - [ ] The ringing screen is described as drawn by the system
 - [ ] Custom countdown and paused UI lives in the widget extension with the same attributes and `AlarmPresentationState`
-- [ ] Hand-offs to `widgetkit`, `activitykit` and `push-notifications` are explicit
+- [ ] Hand-offs to `widgetkit`, `live-activities` and `push-notifications` are explicit
 - [ ] Setup cites only documented requirements; no `com.apple.developer.alarmkit` unless Apple documents it
 - [ ] `tintColor` is set on `AlarmAttributes` so the alarm is recognisable
 - [ ] `AlarmManager.AlarmError.maximumLimitReached` is handled

package/pipeline/skills/shared/external/alarmkit/evals/evals.json

@@ -31,14 +31,14 @@
     {
       "id": 2,
       "prompt": "Product wants AlarmKit to also drive our Smart Stack widget, our delivery-tracking Live Activity and our marketing push notifications, with a fully custom design for the ringing screen. Which parts belong to AlarmKit?",
-      "expected_output": "Limits AlarmKit to system alarms and countdowns and their types, explains that the alerting UI is system-managed while countdown and paused UI can be customised in a widget extension, lists Lock Screen, Dynamic Island, StandBy and paired Apple Watch without Smart Stack, and routes widgets to widgetkit, other Live Activities to activitykit and notifications to push-notifications.",
+      "expected_output": "Limits AlarmKit to system alarms and countdowns and their types, explains that the alerting UI is system-managed while countdown and paused UI can be customised in a widget extension, lists Lock Screen, Dynamic Island, StandBy and paired Apple Watch without Smart Stack, and routes widgets to widgetkit, other Live Activities to live-activities and notifications to push-notifications.",
       "files": [],
       "expectations": [
         "Keeps AlarmKit scope to system alarms and countdown timers and their AlarmKit types",
         "States that the alerting UI is drawn by the system and only countdown and paused UI is customisable",
         "Lists Lock Screen, Dynamic Island, StandBy and paired Apple Watch and does not claim Smart Stack",
         "Routes Smart Stack and Home Screen widgets to widgetkit",
-        "Routes the non-alarm Live Activity to activitykit",
+        "Routes the non-alarm Live Activity to live-activities",
         "Routes push notifications to push-notifications"
       ]
     }

package/pipeline/skills/shared/external/app-store-optimization/SKILL.md

@@ -73,6 +73,12 @@ Always state explicitly: popular but irrelevant keywords are rejected; the
 custom page allowance is 70 per app; a test has up to three treatments; In-App
 Events and ratings are ASO work.
 
+Every App Store Connect number in this skill (field lengths, the 70-page
+allowance, three treatments, the 90-day test limit, event media sizes, the
+review-prompt cap) is as Apple's documentation stated it at the time of
+writing. Apple changes these limits, so check App Store Connect Help before
+quoting one as current.
+
 ## Name and subtitle
 
 Search indexes both the name (30 characters) and the subtitle (30 characters),

package/pipeline/skills/shared/external/app-store-optimization/references/keyword-research-methodology.md

@@ -7,6 +7,9 @@ subtitle, keyword field and primary category, and user behavior such as
 downloads, ratings and reviews. The table below is a planning aid, not a list
 of ranking weights.
 
+Limits below are App Store Connect values as Apple's documentation stated them
+at the time of writing; confirm them in App Store Connect Help before quoting.
+
 | Field | Role in search | Limit | Changing it | Guidance |
 |---|---|---|---|---|
 | App name | Indexed | 30 characters | With a new version, when status allows | Distinctive, and hints at what the app does |

package/pipeline/skills/shared/external/app-store-optimization/references/product-page-variants.md

@@ -1,5 +1,8 @@
 # Product Page Variants
 
+Limits below are App Store Connect values as Apple's documentation stated them
+at the time of writing; confirm them in App Store Connect Help before quoting.
+
 ## Custom Product Pages
 
 ### Setting one up

package/pipeline/skills/shared/external/app-store-review/SKILL.md

@@ -12,10 +12,9 @@ privacy declaration that disagrees with what the binary actually sends, a
 purchase path that skips StoreKit, or metadata that promises something the app
 does not do. This skill finds those before App Review does.
 
-Apple's fraud-prevention report of May 2026 said App Review looked at more than
-9.1 million submissions during 2025 and turned down over 2 million of them.
-Numbers like these change every year, so confirm them against Apple's own
-publication before quoting them.
+Apple publishes a yearly App Store fraud-prevention report with the number of
+submissions App Review looked at and turned down. Quote those figures only from
+the current report, never from memory.
 
 ## Scope and boundaries
 

package/pipeline/skills/shared/external/apple-on-device-ai/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: apple-on-device-ai
-description: "On-device AI on Apple hardware: Foundation Models (SystemLanguageModel, LanguageModelSession, @Generable and @Guide structured output, tool calling), coremltools conversion, quantization, palettization, pruning, Neural Engine and MLTensor, MLX Swift transformer inference on unified memory, llama.cpp GGUF models. Use when building tool-calling AI features, designing guided generation schemas, converting a model or running inference on device. Not for Swift-side Core ML integration (coreml), OCR, sentiment, NER or classifier training."
+description: "On-device AI on Apple hardware: Foundation Models (SystemLanguageModel, LanguageModelSession, @Generable and @Guide structured output, tool calling), coremltools conversion, quantization, palettization, pruning, Neural Engine, MLX Swift transformer inference on unified memory, llama.cpp GGUF models. Use when building tool-calling AI features, designing guided generation schemas, converting a model or running inference on device. Not for Swift-side Core ML integration (coreml), OCR, sentiment, NER or classifier training."
 metadata:
   source: multi-agent-pipeline
 ---
@@ -320,8 +320,10 @@ Compression at a glance:
 
 Boundary: this skill decides which framework to use and owns the Python side
 (conversion, compression, profiling). The `coreml` skill owns the Swift side:
-loading models in the app, runtime settings, calling predictions, and hooking
-models into Vision requests.
+loading models in the app, runtime settings, calling predictions, `MLTensor`
+pre- and post-processing, and hooking models into Vision requests. The
+[optimization guide](references/coreml-optimization.md#mltensor) keeps a short
+`MLTensor` example.
 
 Conversion: [the conversion guide](references/coreml-conversion.md).
 Compression and profiling: [the optimization guide](references/coreml-optimization.md).

package/pipeline/skills/shared/external/authentication/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: authentication
-description: "iOS sign-in with AuthenticationServices and LocalAuthentication: Sign in with Apple, passkey (WebAuthn) registration and login via ASAuthorizationPlatformPublicKeyCredentialProvider, ASAuthorizationController credential state and revocation, ASWebAuthenticationSession OAuth and third-party login, Password AutoFill, server-side identity-token validation, LAContext biometric re-authentication. Use when adding or reviewing account flows."
+description: "iOS sign-in with AuthenticationServices and LocalAuthentication: Sign in with Apple, passkey (WebAuthn) sign-up and login via ASAuthorizationPlatformPublicKeyCredentialProvider, ASAuthorizationController credential state and revocation, ASWebAuthenticationSession OAuth, third-party login, Password AutoFill, server identity-token validation, LAContext biometric re-auth prompts and policy. Use when adding or reviewing account flows."
 metadata:
   source: multi-agent-pipeline
 ---
@@ -44,7 +44,7 @@ extension WelcomeViewController: ASAuthorizationControllerPresentationContextPro
         guard let window = view.window else {
             preconditionFailure("Start Sign in with Apple only while this screen is on screen")
         }
-        return window   // ASPresentationAnchor() with no scene is deprecated in iOS 26
+        return window   // ASPresentationAnchor is UIWindow; UIWindow() is deprecated in iOS 26
     }
 }
 ```
@@ -104,22 +104,30 @@ People can revoke the app at any time under Settings > Apple Account >
 Sign-In & Security, so check on every launch:
 
 ```swift
-func verifyAppleCredential(for userID: String) {
+@MainActor
+func verifyAppleCredential(for userID: String) async {
     let provider = ASAuthorizationAppleIDProvider()
-    provider.getCredentialState(forUserID: userID) { credentialState, _ in
-        DispatchQueue.main.async {
-            switch credentialState {
-            case .authorized:  SessionStore.shared.resume()
-            case .revoked:     SessionStore.shared.signOutAndWipe()
-            case .notFound:    SessionStore.shared.presentLogin()
-            case .transferred: SessionStore.shared.migrateTransferredUser(userID)
-            @unknown default:  SessionStore.shared.presentLogin()
-            }
-        }
+    let credentialState: ASAuthorizationAppleIDProvider.CredentialState
+    do {
+        credentialState = try await provider.credentialState(forUserID: userID)
+    } catch {
+        SessionStore.shared.presentLogin()
+        return
+    }
+    switch credentialState {
+    case .authorized:  SessionStore.shared.resume()
+    case .revoked:     SessionStore.shared.signOutAndWipe()
+    case .notFound:    SessionStore.shared.presentLogin()
+    case .transferred: SessionStore.shared.migrateTransferredUser(userID)
+    @unknown default:  SessionStore.shared.presentLogin()
     }
 }
 ```
 
+The function runs on the main actor and awaits the async form of
+`getCredentialState(forUserID:completion:)`, so the session calls need no hop
+back to the main queue.
+
 `.transferred` means the app moved to a different developer team and the user
 identifier must be migrated. Also subscribe to
 `ASAuthorizationAppleIDProvider.credentialRevokedNotification` and sign the
@@ -133,6 +141,7 @@ backend and keep only what it returns:
 ```swift
 enum SessionAPI {
     struct Session: Decodable { let accessToken: String }
+    private static let transport = URLSession(configuration: .ephemeral)
 
     static func exchange(token: Data?, code: Data?) async throws {
         guard let token, let code,
@@ -144,7 +153,7 @@ enum SessionAPI {
         call.httpMethod = "POST"
         call.addValue("application/json", forHTTPHeaderField: "Content-Type")
         let body = try JSONEncoder().encode(["identity_token": jwt, "authorization_code": grant])
-        let (bytes, reply) = try await URLSession(configuration: .ephemeral).upload(for: call, from: body)
+        let (bytes, reply) = try await transport.upload(for: call, from: body)
         let status = (reply as? HTTPURLResponse)?.statusCode ?? 0
         if status != 200 { throw URLError(.userAuthenticationRequired) }
 
@@ -312,8 +321,11 @@ func confirmOwner() async -> Bool {
 }
 ```
 
-Info.plist must include `NSFaceIDUsageDescription`; without it the app crashes
-on Face ID hardware.
+Info.plist must include `NSFaceIDUsageDescription`, the same rule the
+`swift-security` skill sets for biometric keychain items. The `LAContext` header
+asks apps to supply it: its string is shown the first time the app uses Face ID,
+and once the user denies Face ID for the app, evaluations fail with
+`LAError.biometryNotAvailable`.
 
 ## Security boundaries
 
@@ -326,7 +338,7 @@ Keychain, and `LAContext.evaluatePolicy` on its own must never unlock a
 protected secret.
 
 Hand off to `swift-security`: Keychain architecture and migration,
-access-control policy design, CryptoKit, Secure Enclave, certificate pinning
+biometric-gated keychain items and their access-control policy, CryptoKit, Secure Enclave, certificate pinning
 and trust evaluation, sharing items between apps, hardening local storage, and
 mapping against OWASP MASVS/MASTG. App and device attestation belongs to `device-integrity`.
 

package/pipeline/skills/shared/external/authentication/references/keychain-biometric.md

@@ -104,7 +104,9 @@ func unlockSettings(reason: String) async throws -> Bool {
 ### Info.plist
 
 Add `NSFaceIDUsageDescription` with a sentence explaining why the app uses
-Face ID. Face ID devices crash the app if it is missing.
+Face ID. The `LAContext` header asks for this key; the system shows the string
+the first time the app uses Face ID, and evaluations fail with
+`LAError.biometryNotAvailable` once the user denies Face ID for the app.
 
 ### Tuning the context
 

package/pipeline/skills/shared/external/background-processing/SKILL.md

@@ -113,10 +113,7 @@ func perform(_ task: BGTask, _ job: @escaping @Sendable () async throws -> Void)
         let finished = (try? await job()) != nil
         task.setTaskCompleted(success: finished && !Task.isCancelled)
     }
-    task.expirationHandler = {
-        work.cancel()
-        task.setTaskCompleted(success: false)
-    }
+    task.expirationHandler = { work.cancel() }
 }
 ```
 
@@ -124,7 +121,11 @@ func perform(_ task: BGTask, _ job: @escaping @Sendable () async throws -> Void)
 processing example below reuses `perform`. Two habits matter: schedule the
 next run first, so a crash or expiry does not break the chain, and always
 install an `expirationHandler`, because the system can take the time back at
-any moment.
+any moment. The handler only cancels; the work `Task` is the one completion
+path, so `setTaskCompleted(success:)` runs exactly once, with `false` after an
+expiry. That relies on the job honouring cancellation (`URLSession` async calls
+and `Task.checkCancellation()` throw), so the `Task` ends soon after the
+handler fires.
 
 `BGTask` is not `Sendable`, yet both the work `Task` and the expiration
 handler need it, and the handler runs on a queue the framework picks. The
@@ -165,7 +166,7 @@ the app. It differs from the other two types:
 - Under resource pressure the system may end it, and tasks reporting little
   progress go first.
 - The user or the system can cancel it; the `expirationHandler` must stop the
-  work and remove partial output before completing.
+  work and remove partial output, and the cancelled work then completes once.
 - Its handler is exempt from the register-at-launch rule. `submit` expects
   an identifier that already has a handler, so register the job's identifier
   right before submitting it.
@@ -346,7 +347,8 @@ func application(_ app: UIApplication,
 - **Skipping `setTaskCompleted(success:)`.** The system schedules the app less
   often afterwards. Complete on every path, errors included.
 - **No expiration handler.** The task is killed abruptly instead of stopping
-  cleanly. Cancel the work and complete from the handler.
+  cleanly. Cancel the work from the handler and let the cancelled work report
+  `success: false`, so completion happens once.
 - **Asking too often.** A refresh every minute gets throttled hard. Use 15
   minutes or more, and remember `earliestBeginDate` is a hint.
 - **Too much work per run.** A ten-minute job inside a refresh task will not
@@ -359,7 +361,7 @@ func application(_ app: UIApplication,
 - [ ] `UIBackgroundModes` has `fetch` and/or `processing` as needed
 - [ ] Refresh and processing handlers are registered before launch completes;
       continued processing handlers are registered before their `submit`
-- [ ] `setTaskCompleted(success:)` runs on every path
+- [ ] `setTaskCompleted(success:)` runs exactly once on every path
 - [ ] `expirationHandler` cancels in-flight work
 - [ ] The handler schedules the next task
 - [ ] `earliestBeginDate` is sensible and read as a lower bound only

package/pipeline/skills/shared/external/background-processing/references/background-task-patterns.md

@@ -94,14 +94,14 @@ func backUp(_ task: BGProcessingTask, assets: [PhotoAsset]) {
             task.setTaskCompleted(success: false)
         }
     }
-    task.expirationHandler = {
-        work.cancel()
-        task.setTaskCompleted(success: false)
-    }
+    task.expirationHandler = { work.cancel() }
 }
 ```
 
-When the window closes, the saved cursor lets the next run skip what is done.
+When the window closes, the handler cancels the work, `checkCancellation()`
+throws, and the `catch` reports `success: false`: one completion path, as in
+`perform` and `handleExport`. The saved cursor lets the next run skip what is
+done.
 The `nonisolated(unsafe)` copy lets the non-`Sendable` `BGTask` be shared by
 the work `Task` and the expiration handler under Swift 6.
 
@@ -257,8 +257,8 @@ listed. GPU use also depends on the Background GPU Access entitlement.
 ### Cancellation from the Live Activity
 
 The user can stop the job from the system Live Activity. That arrives through
-`expirationHandler`: cancel the work, delete partial output, and complete with
-`success: false`.
+`expirationHandler`: cancel the work and delete partial output there; the
+cancelled work then completes with `success: false`, as `handleExport` does.
 
 ### Progress drives survival
 

package/pipeline/skills/shared/external/callkit-voip/SKILL.md

@@ -70,9 +70,12 @@ delegate conformance below is `@preconcurrency`, so those callbacks run as
 main-actor code and the `Task` each one starts inherits that isolation. That is
 what lets a `Task` hold on to the non-`Sendable` `CXAction` and `CXProvider`
 it was handed; from a nonisolated method Swift 6 rejects the same capture with
-"passing closure as a 'sending' parameter risks causing data races". The name the
-system shows comes from `localizedName`; on current SDKs it is read from the
-bundle display name, and the old `init(localizedName:)` is deprecated.
+"passing closure as a 'sending' parameter risks causing data races". The
+system shows the app's bundle display name for the provider. The
+`localizedName` property ("No longer supported") and `init(localizedName:)`
+(replaced by `init()`) are both deprecated as of iOS 14 and Mac Catalyst 14,
+so create the configuration with `CXProviderConfiguration()` and do not set a
+name.
 
 ## Incoming call flow