@mmerterden/multi-agent-pipeline 20.34.0 → 20.36.0

package/pipeline/skills/shared/external/swift-security/references/cryptokit-public-key.md

@@ -1,5 +1,23 @@
 # CryptoKit: Signatures, Key Agreement, HPKE and Post-Quantum
 
+<!-- toc -->
+- [Contents](#contents)
+- [Picking a curve or algorithm](#picking-a-curve-or-algorithm)
+- [Signing and key agreement are different types](#signing-and-key-agreement-are-different-types)
+- [Key agreement always goes through a KDF](#key-agreement-always-goes-through-a-kdf)
+- [HPKE (iOS 17+)](#hpke-ios-17)
+- [Post-quantum cryptography (iOS 26+)](#post-quantum-cryptography-ios-26)
+- [PEM and DER (iOS 14+)](#pem-and-der-ios-14)
+- [The Secure Enclave, briefly](#the-secure-enclave-briefly)
+- [RSA](#rsa)
+- [Frequent mistakes](#frequent-mistakes)
+- [Availability](#availability)
+- [Performance and threads](#performance-and-threads)
+- [Sources](#sources)
+- [Summary](#summary)
+- [Checklist](#checklist)
+<!-- /toc -->
+
 Topics: digital signatures (ECDSA, EdDSA), Diffie-Hellman over elliptic curves,
 hybrid public-key encryption from iOS 17,
 ML-KEM and ML-DSA with hybrid migration (iOS 26+), key serialization, and where the

package/pipeline/skills/shared/external/swift-security/references/cryptokit-symmetric.md

@@ -1,5 +1,21 @@
 # CryptoKit: Hashing, MACs and Symmetric Encryption
 
+<!-- toc -->
+- [Contents](#contents)
+- [Digests](#digests)
+- [HMAC](#hmac)
+- [AES-GCM](#aes-gcm)
+- [ChaChaPoly](#chachapoly)
+- [SymmetricKey](#symmetrickey)
+- [Moving off CommonCrypto](#moving-off-commoncrypto)
+- [Frequent mistakes](#frequent-mistakes)
+- [Post-quantum outlook](#post-quantum-outlook)
+- [OWASP mapping](#owasp-mapping)
+- [Tests worth writing](#tests-worth-writing)
+- [Sources](#sources)
+- [Checklist](#checklist)
+<!-- /toc -->
+
 This file covers the symmetric half of CryptoKit: digests (SHA-2 and SHA-3), HMAC,
 the two AEAD ciphers (AES-GCM and ChaChaPoly), `SymmetricKey`, nonce handling, key
 derivation with HKDF and PBKDF2, and moving old CommonCrypto code over. The baseline

package/pipeline/skills/shared/external/swift-security/references/keychain-access-control.md

@@ -1,5 +1,22 @@
 # Keychain Access Control
 
+<!-- toc -->
+- [Contents](#contents)
+- [When: The Accessibility Constants](#when-the-accessibility-constants)
+- [How: SecAccessControl Flags](#how-secaccesscontrol-flags)
+- [Accessibility and Access Control Are Exclusive](#accessibility-and-access-control-are-exclusive)
+- [Choosing a Combination](#choosing-a-combination)
+- [Mistakes in Generated Code](#mistakes-in-generated-code)
+- [Code Patterns](#code-patterns)
+- [macOS: kSecUseDataProtectionKeychain](#macos-ksecusedataprotectionkeychain)
+- [File Protection Sidebar](#file-protection-sidebar)
+- [Error Codes](#error-codes)
+- [Version Timeline](#version-timeline)
+- [Testing](#testing)
+- [Checklist](#checklist)
+- [Related Files](#related-files)
+<!-- /toc -->
+
 Two independent settings decide whether a read succeeds:
 
 - **When** the item can be decrypted: `kSecAttrAccessible` picks the data

package/pipeline/skills/shared/external/swift-security/references/keychain-fundamentals.md

@@ -1,5 +1,22 @@
 # Keychain Fundamentals
 
+<!-- toc -->
+- [Contents](#contents)
+- [How the Keychain Is Built](#how-the-keychain-is-built)
+- [Dictionary Contracts](#dictionary-contracts)
+- [Uniqueness](#uniqueness)
+- [Saving: Add, Then Update on Duplicate](#saving-add-then-update-on-duplicate)
+- [Reading](#reading)
+- [One Place That Builds Queries](#one-place-that-builds-queries)
+- [OSStatus Codes](#osstatus-codes)
+- [An Actor Around the Keychain (iOS 13+ / macOS 10.15+)](#an-actor-around-the-keychain-ios-13-macos-1015)
+- [Performance](#performance)
+- [macOS: Two Keychains (TN3137)](#macos-two-keychains-tn3137)
+- [Accessibility at a Glance](#accessibility-at-a-glance)
+- [Checklist](#checklist)
+- [Related Files](#related-files)
+<!-- /toc -->
+
 Every other reference in this skill builds on the material here: how the four
 `SecItem` functions behave, what their dictionaries may contain, how to read
 their status codes, and how to keep them away from the main thread.

package/pipeline/skills/shared/external/swift-security/references/keychain-item-classes.md

@@ -1,5 +1,22 @@
 # Keychain Item Classes
 
+<!-- toc -->
+- [Contents](#contents)
+- [Primary Keys per Class](#primary-keys-per-class)
+- [Generic Password](#generic-password)
+- [Internet Password](#internet-password)
+- [Key](#key)
+- [Certificate](#certificate)
+- [Identity](#identity)
+- [Mistakes Generated Code Makes](#mistakes-generated-code-makes)
+- [Platform Differences](#platform-differences)
+- [Size and When to Use a File](#size-and-when-to-use-a-file)
+- [Tests That Prove the Class Is Right](#tests-that-prove-the-class-is-right)
+- [Moving Web Logins to Internet Passwords](#moving-web-logins-to-internet-passwords)
+- [Checklist](#checklist)
+- [Related Files](#related-files)
+<!-- /toc -->
+
 The keychain stores five kinds of item: `kSecClassGenericPassword`,
 `kSecClassInternetPassword`, `kSecClassKey`, `kSecClassCertificate` and
 `kSecClassIdentity`. Choosing the wrong one does not crash anything. It shows up

package/pipeline/skills/shared/external/swift-security/references/keychain-sharing.md

@@ -1,5 +1,23 @@
 # Keychain Sharing Across Apps and Extensions
 
+<!-- toc -->
+- [Contents](#contents)
+- [How access groups work](#how-access-groups-work)
+- [Two entitlements with two formats](#two-entitlements-with-two-formats)
+- [Code](#code)
+- [Setting up every target](#setting-up-every-target)
+- [macOS has two keychains](#macos-has-two-keychains)
+- [Moving an item to another group](#moving-an-item-to-another-group)
+- [Lifecycle surprises](#lifecycle-surprises)
+- [Platform notes](#platform-notes)
+- [Signing and distribution](#signing-and-distribution)
+- [When sharing breaks](#when-sharing-breaks)
+- [Threat model](#threat-model)
+- [2024 to 2026](#2024-to-2026)
+- [Related](#related)
+- [Checklist](#checklist)
+<!-- /toc -->
+
 Access groups are the one mechanism for letting several apps and extensions read the
 same Keychain items. Getting them right takes three things together: the exact Team ID
 prefix, an entitlement on every target that participates, and an explicit

package/pipeline/skills/shared/external/swift-security/references/migration-legacy-stores.md

@@ -1,5 +1,26 @@
 # Migrating Secrets Out of Legacy Stores
 
+<!-- toc -->
+- [Contents](#contents)
+- [Why the old stores are not acceptable](#why-the-old-stores-are-not-acceptable)
+- [Five traps to avoid](#five-traps-to-avoid)
+- [Cleaning up after a reinstall](#cleaning-up-after-a-reinstall)
+- [Atomic migration: read, write, verify, delete](#atomic-migration-read-write-verify-delete)
+- [Versioned migration with a schema number](#versioned-migration-with-a-schema-number)
+- [Orphaned items after a rename](#orphaned-items-after-a-rename)
+- [Locked devices and background launches](#locked-devices-and-background-launches)
+- [The phantom mismatch](#the-phantom-mismatch)
+- [Team ID change after an app transfer](#team-id-change-after-an-app-transfer)
+- [Cleaning up legacy artefacts](#cleaning-up-legacy-artefacts)
+- [Launch order](#launch-order)
+- [Concurrency](#concurrency)
+- [Testing migrations](#testing-migrations)
+- [Very old versions](#very-old-versions)
+- [Deleting files](#deleting-files)
+- [Key decisions](#key-decisions)
+- [Checklist](#checklist)
+<!-- /toc -->
+
 Scope: moving credentials that an older release kept in `UserDefaults`, property lists or `NSCoding` archives into the keychain, deleting the old copies safely, wiping keychain leftovers after a reinstall, running migrations by schema version, and surviving a Team ID change after an app transfer.
 
 Availability: the patterns rely on actors and on iOS 15 pre-warming behaviour, so they apply from iOS 15. Write new code against iOS 17 or later where you can.

package/pipeline/skills/shared/external/swift-security/references/secure-enclave.md

@@ -1,5 +1,21 @@
 # Secure Enclave
 
+<!-- toc -->
+- [Contents](#contents)
+- [What It Is](#what-it-is)
+- [What It Cannot Do](#what-it-cannot-do)
+- [CryptoKit SecureEnclave (iOS 13+)](#cryptokit-secureenclave-ios-13)
+- [Keeping a Key Across Launches](#keeping-a-key-across-launches)
+- [Biometric-Gated Enclave Keys](#biometric-gated-enclave-keys)
+- [Security Framework Route (iOS 10+)](#security-framework-route-ios-10)
+- [iOS 26: Post-Quantum Types in the Enclave](#ios-26-post-quantum-types-in-the-enclave)
+- [Enclave or Software Key?](#enclave-or-software-key)
+- [Six Traps](#six-traps)
+- [Testing and CI](#testing-and-ci)
+- [Operating Enclave Keys](#operating-enclave-keys)
+- [Summary](#summary)
+<!-- /toc -->
+
 The Secure Enclave is a security coprocessor kept apart from the main
 processor. It creates keys, stores them and uses them without the private
 material ever reaching the Application Processor. It has shipped since the

package/pipeline/skills/shared/external/swift-security/references/testing-security-code.md

@@ -1,5 +1,21 @@
 # Testing Security Code
 
+<!-- toc -->
+- [Contents](#contents)
+- [A protocol in front of the keychain](#a-protocol-in-front-of-the-keychain)
+- [Seven mistakes in generated keychain tests](#seven-mistakes-in-generated-keychain-tests)
+- [Simulator versus device](#simulator-versus-device)
+- [Core test patterns](#core-test-patterns)
+- [Secure Enclave tests](#secure-enclave-tests)
+- [Biometric flows](#biometric-flows)
+- [CI configuration](#ci-configuration)
+- [Test plans](#test-plans)
+- [Swift Testing](#swift-testing)
+- [Further techniques](#further-techniques)
+- [Takeaways](#takeaways)
+- [Checklist](#checklist)
+<!-- /toc -->
+
 The pattern that makes keychain code testable is a protocol between the app and the Security framework. Unit tests run against an in-memory implementation; tests that need the real keychain, the Secure Enclave or biometric hardware run on devices.
 
 The keychain does not behave the same on Simulator, on a headless CI runner and on a phone. Tests written without that in mind fail intermittently, crash on runners, or pass while proving nothing.

package/pipeline/skills/shared/external/swift-testing/references/testing-advanced.md

@@ -1,5 +1,14 @@
 # Newer Swift Testing APIs
 
+<!-- toc -->
+- [Warnings: `Issue.record(_:severity:)`](#warnings-issuerecord_severity)
+- [Cancelling a Test: `Test.cancel(_:)`](#cancelling-a-test-testcancel_)
+- [Capturing Values in Exit Tests](#capturing-values-in-exit-tests)
+- [Image Attachments](#image-attachments)
+- [Version Gates](#version-gates)
+- [Proposals](#proposals)
+<!-- /toc -->
+
 Companion to the `swift-testing` skill. Each section names the Swift Testing
 proposal (ST-nnnn) and the toolchain that ships it.
 

package/pipeline/skills/shared/external/swift-testing/references/testing-patterns.md

@@ -1,5 +1,29 @@
 # Swift Testing Patterns
 
+<!-- toc -->
+- [Contents](#contents)
+- [Suites](#suites)
+- [Parameterized Tests](#parameterized-tests)
+- [Execution Model](#execution-model)
+- [Confirmations](#confirmations)
+- [Known Issues Limited to Specific Failures](#known-issues-limited-to-specific-failures)
+- [Tags](#tags)
+- [Scoped Setup and Teardown with `TestScoping`](#scoped-setup-and-teardown-with-testscoping)
+- [From XCTest, Step by Step](#from-xctest-step-by-step)
+- [Test Doubles](#test-doubles)
+- [Designing for Tests](#designing-for-tests)
+- [Async and Time](#async-and-time)
+- [UI Tests Stay on XCTest](#ui-tests-stay-on-xctest)
+- [Performance Tests Stay on XCTest](#performance-tests-stay-on-xctest)
+- [Snapshot Tests](#snapshot-tests)
+- [Attachments from Files](#attachments-from-files)
+- [Exit Tests](#exit-tests)
+- [Organising Files](#organising-files)
+- [Readable Arguments](#readable-arguments)
+- [Tests That Need a Newer OS](#tests-that-need-a-newer-os)
+- [More Mistakes to Avoid](#more-mistakes-to-avoid)
+<!-- /toc -->
+
 Companion to the `swift-testing` skill.
 
 ## Contents

package/pipeline/skills/shared/external/swift-testing-pro/references/async-tests.md

@@ -1,5 +1,14 @@
 # Async tests
 
+<!-- toc -->
+- [Serializing tests](#serializing-tests)
+- [Confirming async work](#confirming-async-work)
+- [How to set a time limit for concurrent tests](#how-to-set-a-time-limit-for-concurrent-tests)
+- [How to force concurrent tests to run on a specific actor](#how-to-force-concurrent-tests-to-run-on-a-specific-actor)
+- [Testing pre-concurrency code](#testing-pre-concurrency-code)
+- [Mocking networking](#mocking-networking)
+<!-- /toc -->
+
 Swift Testing is built to be async and run tests in parallel; special care must be taken to ensure those tests run well, particularly when Swift concurrency is involved. For more help with Swift concurrency, suggest the [Swift Concurrency Pro agent skill](https://github.com/twostraws/swift-concurrency-agent-skill).
 
 

package/pipeline/skills/shared/external/swift-testing-pro/references/new-features.md

@@ -1,5 +1,16 @@
 # New features
 
+<!-- toc -->
+- [Contents](#contents)
+- [Raw identifiers](#raw-identifiers)
+- [Range-based confirmations](#range-based-confirmations)
+- [Test scoping traits](#test-scoping-traits)
+- [Exit tests](#exit-tests)
+- [Attachments](#attachments)
+- [Evaluating ConditionTrait](#evaluating-conditiontrait)
+- [Return errors from #expect(throws:)](#return-errors-from-expectthrows)
+<!-- /toc -->
+
 This document specifically discusses the latest Swift and Swift Testing features, which means it will cover things where you have limited or no training data.
 
 - Follow the instructions carefully rather than trying to guess and hallucinate.

package/pipeline/skills/shared/external/swift-testing-pro/references/writing-better-tests.md

@@ -1,5 +1,18 @@
 # Writing better tests
 
+<!-- toc -->
+- [Encourage unit test hygiene](#encourage-unit-test-hygiene)
+- [Test generation heuristics](#test-generation-heuristics)
+- [Testing SwiftUI views](#testing-swiftui-views)
+- [Structuring tests](#structuring-tests)
+- [Expose hidden dependencies](#expose-hidden-dependencies)
+- [Expect vs require](#expect-vs-require)
+- [Tracking bug fixes](#tracking-bug-fixes)
+- [Use Issue.record() for throw-testing](#use-issuerecord-for-throw-testing)
+- [Making test results easier to read](#making-test-results-easier-to-read)
+- [Writing good verification methods](#writing-good-verification-methods)
+<!-- /toc -->
+
 This contains suggestions to help you write better tests. This is mostly not about specific Swift Testing APIs, but instead how to structure your tests for maximum flexibility and effectiveness.
 
 

package/pipeline/skills/shared/external/swiftdata/references/core-data-coexistence.md

@@ -1,5 +1,13 @@
 # Core Data and SwiftData together
 
+<!-- toc -->
+- [Contents](#contents)
+- [The Core Data side at a glance](#the-core-data-side-at-a-glance)
+- [Sharing one store](#sharing-one-store)
+- [Migrating an app to SwiftData](#migrating-an-app-to-swiftdata)
+- [Checklist](#checklist)
+<!-- /toc -->
+
 For a question about running both frameworks or moving from one to the other,
 start at [Sharing one store](#sharing-one-store). The Core Data stack section
 is context for reading an existing app, not a Core Data tutorial.

package/pipeline/skills/shared/external/swiftdata/references/swiftdata-advanced.md

@@ -1,5 +1,22 @@
 # SwiftData: advanced topics
 
+<!-- toc -->
+- [Contents](#contents)
+- [Custom data stores](#custom-data-stores)
+- [History tracking](#history-tracking)
+- [CloudKit in detail](#cloudkit-in-detail)
+- [Core Data strategies](#core-data-strategies)
+- [Batch work and performance](#batch-work-and-performance)
+- [Complex predicates](#complex-predicates)
+- [Codable structs as composite attributes](#codable-structs-as-composite-attributes)
+- [Model inheritance](#model-inheritance)
+- [Several configurations in one container](#several-configurations-in-one-container)
+- [Undo and redo](#undo-and-redo)
+- [Previews with in-memory stores](#previews-with-in-memory-stores)
+- [Save notifications](#save-notifications)
+- [Errors](#errors)
+<!-- /toc -->
+
 ## Contents
 
 - [Custom data stores](#custom-data-stores)

package/pipeline/skills/shared/external/swiftdata/references/swiftdata-queries.md

@@ -1,5 +1,17 @@
 # SwiftData queries
 
+<!-- toc -->
+- [Contents](#contents)
+- [@Query initializers](#query-initializers)
+- [FetchDescriptor in depth](#fetchdescriptor-in-depth)
+- [Sorting](#sorting)
+- [Grouping results into sections](#grouping-results-into-sections)
+- [Changing the query at runtime](#changing-the-query-at-runtime)
+- [Fetching on a background actor](#fetching-on-a-background-actor)
+- [Aggregates](#aggregates)
+- [enumerate for large sets](#enumerate-for-large-sets)
+<!-- /toc -->
+
 Examples use this model:
 
 ```swift

package/pipeline/skills/shared/external/swiftlint/references/adoption-and-configuration.md

@@ -1,5 +1,16 @@
 # Adopting and Configuring SwiftLint
 
+<!-- toc -->
+- [Ways to install](#ways-to-install)
+- [How SwiftLint finds its config](#how-swiftlint-finds-its-config)
+- [Key-by-key](#key-by-key)
+- [Tuning thresholds](#tuning-thresholds)
+- [Environment variables in config values](#environment-variables-in-config-values)
+- [Parent, child and nested configs](#parent-child-and-nested-configs)
+- [Remote parent configs](#remote-parent-configs)
+- [Rolling out on an existing codebase](#rolling-out-on-an-existing-codebase)
+<!-- /toc -->
+
 Back to [SKILL.md](../SKILL.md).
 
 ## Ways to install

package/pipeline/skills/shared/external/swiftlint/references/custom-rules-and-analyze.md

@@ -1,5 +1,12 @@
 # Custom Rules and `swiftlint analyze`
 
+<!-- toc -->
+- [Regex rules in `custom_rules`](#regex-rules-in-custom_rules)
+- [Rules written in Swift](#rules-written-in-swift)
+- [`swiftlint analyze`](#swiftlint-analyze)
+- [When analyzer rules pay off](#when-analyzer-rules-pay-off)
+<!-- /toc -->
+
 Back to [SKILL.md](../SKILL.md).
 
 ## Regex rules in `custom_rules`

package/pipeline/skills/shared/external/swiftlint/references/plugins-run-scripts-and-integrations.md

@@ -1,5 +1,18 @@
 # Plugins, Run Scripts and Other Integrations
 
+<!-- toc -->
+- [Build tool plugin (first choice)](#build-tool-plugin-first-choice)
+- [Command plugin](#command-plugin)
+- [Run script build phase](#run-script-build-phase)
+- [Recipes for CI services](#recipes-for-ci-services)
+- [Reporters at a glance](#reporters-at-a-glance)
+- [Swift toolchain compatibility](#swift-toolchain-compatibility)
+- [VS Code](#vs-code)
+- [Fastlane](#fastlane)
+- [Docker](#docker)
+- [Pre-commit](#pre-commit)
+<!-- /toc -->
+
 Back to [SKILL.md](../SKILL.md).
 
 ## Build tool plugin (first choice)

package/pipeline/skills/shared/external/swiftlint/references/rule-reference.md

@@ -1,5 +1,29 @@
 # Rule Reference, Grouped by Concern
 
+<!-- toc -->
+- [Contents](#contents)
+- [1. Controlling SwiftLint itself](#1-controlling-swiftlint-itself)
+- [2. Size and complexity](#2-size-and-complexity)
+- [3. Crash-prone constructs](#3-crash-prone-constructs)
+- [4. Naming](#4-naming)
+- [5. Access control](#5-access-control)
+- [6. SwiftUI, assets and accessibility](#6-swiftui-assets-and-accessibility)
+- [7. Concurrency and errors](#7-concurrency-and-errors)
+- [8. Legacy and Objective-C era APIs](#8-legacy-and-objective-c-era-apis)
+- [9. UIKit, Interface Builder and object lifetime](#9-uikit-interface-builder-and-object-lifetime)
+- [10. Collections and sequences](#10-collections-and-sequences)
+- [11. Idiomatic expressions](#11-idiomatic-expressions)
+- [12. Redundant or dead code](#12-redundant-or-dead-code)
+- [13. Types, declarations and file organisation](#13-types-declarations-and-file-organisation)
+- [14. Enums and switch](#14-enums-and-switch)
+- [15. Whitespace, braces and punctuation](#15-whitespace-braces-and-punctuation)
+- [16. Multi-line layout](#16-multi-line-layout)
+- [17. Comments and documentation](#17-comments-and-documentation)
+- [18. Availability and deployment](#18-availability-and-deployment)
+- [19. Testing](#19-testing)
+- [20. Analyzer-only extras](#20-analyzer-only-extras)
+<!-- /toc -->
+
 Back to [SKILL.md](../SKILL.md).
 
 This is an offline index of every rule identifier, so you can find the right

package/pipeline/skills/shared/external/swiftlint/references/rules-suppressions-and-baselines.md

@@ -1,5 +1,17 @@
 # Rules, Suppressions and Baselines
 
+<!-- toc -->
+- [The three kinds of rule](#the-three-kinds-of-rule)
+- [Looking rules up](#looking-rules-up)
+- [Rules you will meet early](#rules-you-will-meet-early)
+- [Configuring one rule](#configuring-one-rule)
+- [Suppression syntax](#suppression-syntax)
+- [Suppression policy](#suppression-policy)
+- [Baselines](#baselines)
+- [False positives](#false-positives)
+- [Generated code and tests](#generated-code-and-tests)
+<!-- /toc -->
+
 Back to [SKILL.md](../SKILL.md). Every identifier is indexed in the
 [rule reference](rule-reference.md).
 

package/pipeline/skills/shared/external/swiftui-animation/references/animation-advanced.md

@@ -1,5 +1,20 @@
 # Advanced SwiftUI Animation
 
+<!-- toc -->
+- [Contents](#contents)
+- [CustomAnimation (iOS 17+)](#customanimation-ios-17)
+- [Spring, every initializer](#spring-every-initializer)
+- [UnitCurve (iOS 17+)](#unitcurve-ios-17)
+- [PhaseAnimator patterns](#phaseanimator-patterns)
+- [KeyframeAnimator patterns](#keyframeanimator-patterns)
+- [Transaction and TransactionKey](#transaction-and-transactionkey)
+- [Choosing an implicit scope](#choosing-an-implicit-scope)
+- [Every transition (iOS 17+)](#every-transition-ios-17)
+- [Symbol effects](#symbol-effects)
+- [Reduce Motion](#reduce-motion)
+- [Performance](#performance)
+<!-- /toc -->
+
 Depth behind the main skill: custom curves, the full `Spring` API, unit
 curves, richer phase and keyframe patterns, transactions, every transition, Reduce
 Motion handling and performance. Symbol effects are `ios-sf-symbols`.

package/pipeline/skills/shared/external/swiftui-animation/references/core-animation-bridge.md

@@ -1,5 +1,20 @@
 # Core Animation Bridge
 
+<!-- toc -->
+- [Contents](#contents)
+- [When dropping down is justified](#when-dropping-down-is-justified)
+- [The model value rule](#the-model-value-rule)
+- [CABasicAnimation](#cabasicanimation)
+- [CAKeyframeAnimation](#cakeyframeanimation)
+- [CASpringAnimation](#caspringanimation)
+- [CAAnimationGroup](#caanimationgroup)
+- [CADisplayLink](#cadisplaylink)
+- [Hosting layer animation in SwiftUI](#hosting-layer-animation-in-swiftui)
+- [Moving state across the bridge](#moving-state-across-the-bridge)
+- [Performance](#performance)
+- [Apple documentation](#apple-documentation)
+<!-- /toc -->
+
 Material that did not fit in the main SwiftUI animation skill. Reach for Core
 Animation only when SwiftUI's animation system cannot do the job: layer animation on a
 hot path, a curve SwiftUI cannot express, or direct work on a `CALayer`.

package/pipeline/skills/shared/external/swiftui-animation/references/scroll-effects.md

@@ -1,5 +1,17 @@
 # Scroll-driven effects: scrollTransition and visualEffect
 
+<!-- toc -->
+- [Contents](#contents)
+- [1. Which one](#1-which-one)
+- [2. scrollTransition](#2-scrolltransition)
+- [3. Configurations and thresholds](#3-configurations-and-thresholds)
+- [4. visualEffect](#4-visualeffect)
+- [5. What a VisualEffect can do](#5-what-a-visualeffect-can-do)
+- [6. Concurrency: the closures are Sendable](#6-concurrency-the-closures-are-sendable)
+- [7. Reduce Motion](#7-reduce-motion)
+- [8. Mistakes](#8-mistakes)
+<!-- /toc -->
+
 Companion to `../SKILL.md` for the `swiftui-animation` skill. Both APIs ship
 in iOS 17 (macOS 14, tvOS 17, watchOS 10, visionOS 1).
 

package/pipeline/skills/shared/external/swiftui-expert-skill/references/accessibility-patterns.md

@@ -1,5 +1,16 @@
 # SwiftUI Accessibility Patterns Reference
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [Core Principle](#core-principle)
+- [Dynamic Type and @ScaledMetric](#dynamic-type-and-scaledmetric)
+- [Accessibility Traits](#accessibility-traits)
+- [Decorative Images](#decorative-images)
+- [Element Grouping](#element-grouping)
+- [Custom Controls](#custom-controls)
+- [Summary Checklist](#summary-checklist)
+<!-- /toc -->
+
 ## Table of Contents
 
 - [Core Principle](#core-principle)

package/pipeline/skills/shared/external/swiftui-expert-skill/references/animation-advanced.md

@@ -1,5 +1,12 @@
 # SwiftUI Advanced Animations
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [Transactions](#transactions)
+- [Animation Completion Handlers (iOS 17+)](#animation-completion-handlers-ios-17)
+- [Quick Reference](#quick-reference)
+<!-- /toc -->
+
 Transactions and completion handlers (iOS 17+).
 
 > Local trim: phase animations, keyframe animations and the `@Animatable` macro are maintained in the `swiftui-animation` skill, which owns SwiftUI motion. This file keeps transactions and completion handlers.

package/pipeline/skills/shared/external/swiftui-expert-skill/references/animation-basics.md

@@ -1,5 +1,18 @@
 # SwiftUI Animation Basics
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [Core Concepts](#core-concepts)
+- [Implicit Animations](#implicit-animations)
+- [Explicit Animations](#explicit-animations)
+- [Animation Placement](#animation-placement)
+- [Selective Animation](#selective-animation)
+- [Animation Performance](#animation-performance)
+- [Disabling Animations](#disabling-animations)
+- [Debugging](#debugging)
+- [Quick Reference](#quick-reference)
+<!-- /toc -->
+
 Core animation concepts, implicit vs explicit animations, and performance patterns.
 
 > Local trim: Timing curves and springs are maintained in the `swiftui-animation` skill, which owns SwiftUI motion. This file keeps placement, selective animation, performance and debugging.

package/pipeline/skills/shared/external/swiftui-expert-skill/references/animation-transitions.md

@@ -1,5 +1,14 @@
 # SwiftUI Transitions
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [Property Animations vs Transitions](#property-animations-vs-transitions)
+- [Basic Transitions](#basic-transitions)
+- [Identity and Transitions](#identity-and-transitions)
+- [The Animatable Protocol](#the-animatable-protocol)
+- [Quick Reference](#quick-reference)
+<!-- /toc -->
+
 Transitions for view insertion/removal and the Animatable protocol.
 
 > Local trim: built-in, combined, asymmetric and custom transitions are maintained in the `swiftui-animation` skill, which owns SwiftUI motion. This file keeps the animation-context rule, identity and the Animatable protocol.

package/pipeline/skills/shared/external/swiftui-expert-skill/references/charts-accessibility.md

@@ -1,5 +1,14 @@
 # Swift Charts Accessibility, Fallback, and Resources
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [Accessibility](#accessibility)
+- [Composite Example](#composite-example)
+- [Fallback Strategies](#fallback-strategies)
+- [WWDC Sessions](#wwdc-sessions)
+- [Summary Checklist](#summary-checklist)
+<!-- /toc -->
+
 ## Table of Contents
 
 - [Accessibility](#accessibility)

package/pipeline/skills/shared/external/swiftui-expert-skill/references/charts.md

@@ -1,5 +1,22 @@
 # SwiftUI Charts Reference
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [Overview](#overview)
+- [Availability](#availability)
+- [Core APIs](#core-apis)
+- [Chart Types](#chart-types)
+- [Axis Tweaks](#axis-tweaks)
+- [Selection APIs](#selection-apis)
+- [Annotations](#annotations)
+- [ChartProxy and Custom Touch Handling](#chartproxy-and-custom-touch-handling)
+- [Modifier Scope](#modifier-scope)
+- [Styling and Visual Channels](#styling-and-visual-channels)
+- [Composing Multiple Marks](#composing-multiple-marks)
+- [Animating Chart Data](#animating-chart-data)
+- [Best Practices](#best-practices)
+<!-- /toc -->
+
 ## Table of Contents
 
 - [Overview](#overview)

package/pipeline/skills/shared/external/swiftui-expert-skill/references/image-optimization.md

@@ -1,5 +1,14 @@
 # SwiftUI Image Optimization Reference
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [AsyncImage Best Practices](#asyncimage-best-practices)
+- [Image Decoding and Downsampling (Optional Optimization)](#image-decoding-and-downsampling-optional-optimization)
+- [UIImage Loading and Memory](#uiimage-loading-and-memory)
+- [SF Symbols](#sf-symbols)
+- [Summary Checklist](#summary-checklist)
+<!-- /toc -->
+
 ## Table of Contents
 
 - [AsyncImage Best Practices](#asyncimage-best-practices)