@mmerterden/multi-agent-pipeline 20.33.0 → 20.35.0

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)

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

@@ -1,5 +1,15 @@
 # Latest SwiftUI APIs Reference
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [Always Use (iOS 15+)](#always-use-ios-15)
+- [When Targeting iOS 16+](#when-targeting-ios-16)
+- [When Targeting iOS 17+](#when-targeting-ios-17)
+- [When Targeting iOS 18+](#when-targeting-ios-18)
+- [When Targeting iOS 26+](#when-targeting-ios-26)
+- [Quick Lookup Table](#quick-lookup-table)
+<!-- /toc -->
+
 > Based on a comparison of Apple's documentation using the Sosumi MCP, we found the latest recommended APIs to use.
 
 ## Table of Contents

package/pipeline/skills/shared/external/swiftui-expert-skill/references/layout-best-practices.md

@@ -1,5 +1,17 @@
 # SwiftUI Layout Best Practices Reference
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [Relative Layout Over Constants](#relative-layout-over-constants)
+- [Context-Agnostic Views](#context-agnostic-views)
+- [Own Your Container](#own-your-container)
+- [Layout Performance](#layout-performance)
+- [View Logic and Testability](#view-logic-and-testability)
+- [Full-Width Views](#full-width-views)
+- [Action Handlers](#action-handlers)
+- [Summary Checklist](#summary-checklist)
+<!-- /toc -->
+
 ## Table of Contents
 
 - [Relative Layout Over Constants](#relative-layout-over-constants)

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

@@ -1,5 +1,17 @@
 # SwiftUI List Patterns Reference
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [ForEach Identity and Stability](#foreach-identity-and-stability)
+- [Enumerated Sequences](#enumerated-sequences)
+- [List with Custom Styling](#list-with-custom-styling)
+- [List with Pull-to-Refresh](#list-with-pull-to-refresh)
+- [Empty States with ContentUnavailableView (iOS 17+)](#empty-states-with-contentunavailableview-ios-17)
+- [Custom List Backgrounds](#custom-list-backgrounds)
+- [Table](#table)
+- [Summary Checklist](#summary-checklist)
+<!-- /toc -->
+
 ## Table of Contents
 
 - [ForEach Identity and Stability](#foreach-identity-and-stability)

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

@@ -1,5 +1,18 @@
 # macOS Scenes Reference
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [Quick Lookup Table](#quick-lookup-table)
+- [Settings (macOS-only)](#settings-macos-only)
+- [MenuBarExtra (macOS-only)](#menubarextra-macos-only)
+- [WindowGroup (macOS behavior)](#windowgroup-macos-behavior)
+- [Window](#window)
+- [UtilityWindow (macOS-only)](#utilitywindow-macos-only)
+- [DocumentGroup](#documentgroup)
+- [Platform Conditionals](#platform-conditionals)
+- [Best Practices](#best-practices)
+<!-- /toc -->
+
 > SwiftUI scene types for macOS apps  -  `Settings`, `MenuBarExtra`, `WindowGroup`, `Window`, `UtilityWindow`, and `DocumentGroup`. Covers macOS-only scenes and cross-platform scenes with macOS-specific behavior.
 
 ## Table of Contents

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

@@ -1,5 +1,17 @@
 # macOS Views & Components Reference
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [Quick Lookup Table](#quick-lookup-table)
+- [HSplitView & VSplitView (macOS-only)](#hsplitview-vsplitview-macos-only)
+- [Table](#table)
+- [PasteButton & CopyButton](#pastebutton-copybutton)
+- [File Operations](#file-operations)
+- [Drag, Drop & Pasteboard](#drag-drop-pasteboard)
+- [AppKit Interop](#appkit-interop)
+- [Best Practices](#best-practices)
+<!-- /toc -->
+
 > macOS-specific SwiftUI views, file operations, drag & drop, and AppKit interop. Covers `HSplitView`, `VSplitView`, `Table`, `PasteButton`, file dialogs, cross-app drag & drop, and `NSViewRepresentable`.
 
 ## Table of Contents

package/pipeline/skills/shared/external/swiftui-expert-skill/references/macos-window-styling.md

@@ -1,5 +1,17 @@
 # macOS Window & Toolbar Styling Reference
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [Quick Lookup Table](#quick-lookup-table)
+- [Toolbar Styles](#toolbar-styles)
+- [Window Style](#window-style)
+- [Window Sizing](#window-sizing)
+- [MenuBarExtra Style (macOS-only)](#menubarextra-style-macos-only)
+- [Navigation Layout (macOS behavior)](#navigation-layout-macos-behavior)
+- [Commands & Keyboard](#commands-keyboard)
+- [Best Practices](#best-practices)
+<!-- /toc -->
+
 > Window configuration, toolbar styles, sizing, positioning, and navigation patterns specific to macOS SwiftUI apps.
 
 ## Table of Contents

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

@@ -1,5 +1,12 @@
 # SwiftUI Performance Patterns Reference
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [Performance Optimization](#performance-optimization)
+- [Anti-Patterns](#anti-patterns)
+- [Summary Checklist](#summary-checklist)
+<!-- /toc -->
+
 ## Table of Contents
 
 - [Performance Optimization](#performance-optimization)

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

@@ -1,5 +1,14 @@
 # SwiftUI ScrollView Patterns Reference
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [ScrollViewReader for Programmatic Scrolling](#scrollviewreader-for-programmatic-scrolling)
+- [Scroll Position Tracking](#scroll-position-tracking)
+- [Scroll Transitions and Effects](#scroll-transitions-and-effects)
+- [Scroll Target Behavior](#scroll-target-behavior)
+- [Summary Checklist](#summary-checklist)
+<!-- /toc -->
+
 ## Table of Contents
 
 - [ScrollViewReader for Programmatic Scrolling](#scrollviewreader-for-programmatic-scrolling)

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

@@ -1,5 +1,15 @@
 # SwiftUI Sheet, Navigation & Inspector Patterns Reference
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [Sheet Patterns](#sheet-patterns)
+- [Navigation Patterns](#navigation-patterns)
+- [Multi-Column Navigation with NavigationSplitView](#multi-column-navigation-with-navigationsplitview)
+- [Inspector](#inspector)
+- [Presentation Modifiers](#presentation-modifiers)
+- [Summary Checklist](#summary-checklist)
+<!-- /toc -->
+
 ## Table of Contents
 
 - [Sheet Patterns](#sheet-patterns)

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

@@ -1,5 +1,23 @@
 # SwiftUI State Management Reference
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [Property Wrapper Selection Guide](#property-wrapper-selection-guide)
+- [@State](#state)
+- [Property Wrappers Inside @Observable Classes](#property-wrappers-inside-observable-classes)
+- [@Binding](#binding)
+- [@FocusState](#focusstate)
+- [@StateObject vs @ObservedObject (Legacy - Pre-iOS 17)](#stateobject-vs-observedobject-legacy---pre-ios-17)
+- [Don't Pass Values as @State](#dont-pass-values-as-state)
+- [@Bindable (iOS 17+)](#bindable-ios-17)
+- [let vs var for Passed Values](#let-vs-var-for-passed-values)
+- [Environment and Preferences](#environment-and-preferences)
+- [Decision Flowchart](#decision-flowchart)
+- [State Privacy Rules](#state-privacy-rules)
+- [Avoid Nested ObservableObject](#avoid-nested-observableobject)
+- [Key Principles](#key-principles)
+<!-- /toc -->
+
 ## Table of Contents
 
 - [Property Wrapper Selection Guide](#property-wrapper-selection-guide)

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

@@ -1,5 +1,21 @@
 # SwiftUI View Structure Reference
 
+<!-- toc -->
+- [Table of Contents](#table-of-contents)
+- [View Structure Principles](#view-structure-principles)
+- [Prefer Modifiers Over Conditional Views](#prefer-modifiers-over-conditional-views)
+- [Extract Subviews, Not Computed Properties](#extract-subviews-not-computed-properties)
+- [When @ViewBuilder Functions Are Acceptable](#when-viewbuilder-functions-are-acceptable)
+- [When to Extract Subviews](#when-to-extract-subviews)
+- [Container View Pattern](#container-view-pattern)
+- [ZStack vs overlay/background](#zstack-vs-overlaybackground)
+- [Compositing Group Before Clipping](#compositing-group-before-clipping)
+- [Reusable Styling with ViewModifier](#reusable-styling-with-viewmodifier)
+- [Skeleton Loading with Redacted Views](#skeleton-loading-with-redacted-views)
+- [UIViewRepresentable Essentials](#uiviewrepresentable-essentials)
+- [Summary Checklist](#summary-checklist)
+<!-- /toc -->
+
 ## Table of Contents
 
 - [View Structure Principles](#view-structure-principles)

package/pipeline/skills/shared/external/swiftui-gestures/references/gesture-patterns.md

@@ -1,5 +1,16 @@
 # Gesture Patterns
 
+<!-- toc -->
+- [Contents](#contents)
+- [Pinch-to-zoom with MagnifyGesture](#pinch-to-zoom-with-magnifygesture)
+- [Combined rotate and scale](#combined-rotate-and-scale)
+- [Drag-to-reorder](#drag-to-reorder)
+- [Gesture velocity calculations](#gesture-velocity-calculations)
+- [Long-press then drag](#long-press-then-drag)
+- [SwiftUI and UIKit gesture interop](#swiftui-and-uikit-gesture-interop)
+- [Accessibility considerations](#accessibility-considerations)
+<!-- /toc -->
+
 Worked interactions for the `swiftui-gestures` skill. The SKILL.md explains the
 gesture types, composition and `@GestureState`; this file assumes that
 material.

package/pipeline/skills/shared/external/swiftui-layout-components/references/form.md

@@ -1,5 +1,13 @@
 # Forms
 
+<!-- toc -->
+- [When to use Form](#when-to-use-form)
+- [Settings form](#settings-form)
+- [Modal form with validation](#modal-form-with-validation)
+- [Design choices](#design-choices)
+- [Pitfalls](#pitfalls)
+<!-- /toc -->
+
 Form guidance for the `swiftui-layout-components` skill.
 
 ## When to use Form

package/pipeline/skills/shared/external/swiftui-layout-components/references/grids.md

@@ -1,5 +1,19 @@
 # Grids
 
+<!-- toc -->
+- [When a grid is the right shape](#when-a-grid-is-the-right-shape)
+- [Picking the grid type](#picking-the-grid-type)
+- [Column strategies](#column-strategies)
+- [Sizing cells](#sizing-cells)
+- [Adaptive picker with selection](#adaptive-picker-with-selection)
+- [Three-up media gallery](#three-up-media-gallery)
+- [Sections in a grid](#sections-in-a-grid)
+- [Selection and interaction](#selection-and-interaction)
+- [Performance](#performance)
+- [Accessibility](#accessibility)
+- [Pitfalls](#pitfalls)
+<!-- /toc -->
+
 Grid guidance for the `swiftui-layout-components` skill.
 
 ## When a grid is the right shape

package/pipeline/skills/shared/external/swiftui-layout-components/references/scrollview.md

@@ -1,5 +1,14 @@
 # Scroll Views
 
+<!-- toc -->
+- [When to use ScrollView](#when-to-use-scrollview)
+- [Conversation screen](#conversation-screen)
+- [ScrollPosition](#scrollposition)
+- [More shapes](#more-shapes)
+- [Scroll edge effects (iOS 26)](#scroll-edge-effects-ios-26)
+- [Pitfalls](#pitfalls)
+<!-- /toc -->
+
 Scroll view guidance for the `swiftui-layout-components` skill.
 
 ## When to use ScrollView