@mmerterden/multi-agent-pipeline 20.17.0 → 20.17.2

package/pipeline/skills/.skills-index.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": "1.0.0",
-  "skillCount": 223,
+  "skillCount": 228,
   "entries": [
     {
       "name": "accessibility-compliance-accessibility-audit",
@@ -640,6 +640,17 @@
       "triggerPaths": [],
       "relativePath": "shared/external/healthkit/SKILL.md"
     },
+    {
+      "name": "hig-app-icons",
+      "description": "iOS app icons: Icon Composer layered icons, default, dark, clear and tinted appearances, asset catalogs, alternate icons and the archive checks icons fail. Use when designing, exporting, wiring up or reviewing an app icon, or diagnosing an icon upload error or rejection.",
+      "platform": null,
+      "group": "external",
+      "plugin": "ai-ios-toolkit",
+      "invokeAs": "ai-ios-toolkit:hig-app-icons",
+      "triggerKeywords": [],
+      "triggerPaths": [],
+      "relativePath": "shared/external/hig-app-icons/SKILL.md"
+    },
     {
       "name": "hig-components-content",
       "description": "Apple HIG for content views mapped to SwiftUI: lists, tables, grids, charts, images, text, web views, empty states. Use when choosing or reviewing how an Apple-platform app presents content.",
@@ -653,7 +664,7 @@
     },
     {
       "name": "hig-components-layout",
-      "description": "Apple HIG for app structure mapped to SwiftUI: tab bars, split views, navigation stacks, toolbars, sheets, popovers, alerts, windows, iOS 26 Liquid Glass bars. Use when designing layout and navigation on an Apple platform.",
+      "description": "Apple HIG app structure mapped to SwiftUI: tab bars, sidebars, split views, toolbars, sheets and popovers, including the iOS 26 and 27 tab and toolbar APIs. Use when choosing navigation structure or laying out tab bars and toolbars.",
       "platform": null,
       "group": "external",
       "plugin": "ai-ios-toolkit",
@@ -686,7 +697,7 @@
     },
     {
       "name": "hig-foundations",
-      "description": "Apple HIG foundations mapped to SwiftUI: Dynamic Type, semantic color, contrast, safe areas, SF Symbols, materials and Liquid Glass, motion, icons, writing. Use when a design decision turns on Apple's foundations.",
+      "description": "Apple HIG foundations mapped to SwiftUI: typography and Dynamic Type, semantic color, contrast, spacing, safe areas, touch targets, motion and UX writing. Use when a design decision turns on type, color, contrast or spacing.",
       "platform": null,
       "group": "external",
       "plugin": "ai-ios-toolkit",
@@ -697,7 +708,7 @@
     },
     {
       "name": "hig-inputs",
-      "description": "Apple HIG for input mapped to SwiftUI: touch gestures, keyboards, pointer, Apple Pencil, focus and game controllers, Digital Crown, eyes and hands, haptics. Use when designing or reviewing input on an Apple platform.",
+      "description": "Apple HIG for input mapped to SwiftUI: gestures, keyboards, pointer, Apple Pencil, focus, game controllers and Digital Crown. Use when designing or reviewing input on an Apple platform.",
       "platform": null,
       "group": "external",
       "plugin": "ai-ios-toolkit",
@@ -708,7 +719,7 @@
     },
     {
       "name": "hig-patterns",
-      "description": "Apple HIG interaction patterns mapped to SwiftUI: modality, loading, empty and error states, feedback, undo, search, data entry, settings, sharing, accounts. Use when designing a UX flow on an Apple platform.",
+      "description": "Apple HIG interaction patterns mapped to SwiftUI: onboarding, permission requests, loading, empty and error states, modality, search, settings. Use when designing a UX flow on an Apple platform.",
       "platform": null,
       "group": "external",
       "plugin": "ai-ios-toolkit",
@@ -719,7 +730,7 @@
     },
     {
       "name": "hig-platforms",
-      "description": "Apple HIG per platform: iPhone, iPad, Mac, Watch, TV and Vision Pro conventions, and adapting one SwiftUI codebase across them. Use when a design has to fit a specific Apple platform.",
+      "description": "Apple HIG per platform: iPhone, iPad, Mac, Watch, TV and Vision Pro, iPad size classes and windowing. Use when a design has to fit a specific Apple platform or adapt across them.",
       "platform": null,
       "group": "external",
       "plugin": "ai-ios-toolkit",
@@ -774,7 +785,7 @@
     },
     {
       "name": "ios-accessibility",
-      "description": "VoiceOver, Voice Control, Switch Control and Full Keyboard Access in SwiftUI, UIKit and AppKit on iOS, iPadOS and macOS: labels, hints, values, traits, accessibilityInputLabels, NSAccessibility, grouping and reading order, @AccessibilityFocusState focus restore, Dynamic Type and @ScaledMetric, rotor",
+      "description": "VoiceOver, Voice Control, Switch Control and Full Keyboard Access in SwiftUI, UIKit and AppKit: labels, traits, grouping, focus restore, Dynamic Type, Large Content Viewer, rotors, custom actions, accessibility checks and Nutrition Labels. Use when implementing, reviewing or auditing accessibility (",
       "platform": null,
       "group": "external",
       "plugin": "ai-ios-toolkit",
@@ -805,6 +816,39 @@
       "triggerPaths": [],
       "relativePath": "shared/external/ios-debugger-agent/SKILL.md"
     },
+    {
+      "name": "ios-design-review",
+      "description": "Design critique and screenshot-based visual QA of iOS screens against the HIG, checked across light and dark, Dynamic Type, RTL, contrast and transparency settings with simulator tools. Use when asking whether a screen looks right, wanting a design pass on screenshots or a build, or visual QA before",
+      "platform": null,
+      "group": "external",
+      "plugin": "ai-ios-toolkit",
+      "invokeAs": "ai-ios-toolkit:ios-design-review",
+      "triggerKeywords": [],
+      "triggerPaths": [],
+      "relativePath": "shared/external/ios-design-review/SKILL.md"
+    },
+    {
+      "name": "ios-haptics",
+      "description": "Haptic feedback on iPhone: when a haptic adds meaning, sensoryFeedback, the UIFeedbackGenerator family, Core Haptics and AHAP, settings and on-device testing. Use when adding, choosing, reviewing or debugging haptics.",
+      "platform": null,
+      "group": "external",
+      "plugin": "ai-ios-toolkit",
+      "invokeAs": "ai-ios-toolkit:ios-haptics",
+      "triggerKeywords": [],
+      "triggerPaths": [],
+      "relativePath": "shared/external/ios-haptics/SKILL.md"
+    },
+    {
+      "name": "ios-iphone-duo",
+      "description": "Readiness for iPhone Duo, the foldable two-display iPhone on iOS 27.1: fixed-assumption hunting, asymmetric safe areas, reserved regions, ArrangementView, hinge changes, vertical bars and dual-pane patterns. Use when preparing, auditing or designing an app for iPhone Duo, the fold or vertical toolba",
+      "platform": null,
+      "group": "external",
+      "plugin": "ai-ios-toolkit",
+      "invokeAs": "ai-ios-toolkit:ios-iphone-duo",
+      "triggerKeywords": [],
+      "triggerPaths": [],
+      "relativePath": "shared/external/ios-iphone-duo/SKILL.md"
+    },
     {
       "name": "ios-localization",
       "description": "i18n and l10n for iOS and macOS: String Catalogs (.xcstrings), generated localizable symbols with compile-time-checked keys, stable key naming, LocalizedStringKey, LocalizedStringResource, String(localized:), plurals, device variations, locale-aware FormatStyle for numbers, dates, currency and measu",
@@ -849,6 +893,17 @@
       "triggerPaths": [],
       "relativePath": "shared/external/ios-security/SKILL.md"
     },
+    {
+      "name": "ios-sf-symbols",
+      "description": "SF Symbols in SwiftUI and UIKit: rendering modes, variable values, symbol effects including Draw On and Off, matching weight and scale to text, custom symbols and accessibility labels. Use when picking, styling, animating or reviewing symbols, or building a custom symbol.",
+      "platform": null,
+      "group": "external",
+      "plugin": "ai-ios-toolkit",
+      "invokeAs": "ai-ios-toolkit:ios-sf-symbols",
+      "triggerKeywords": [],
+      "triggerPaths": [],
+      "relativePath": "shared/external/ios-sf-symbols/SKILL.md"
+    },
     {
       "name": "ios-simulator",
       "description": "xcrun simctl from the command line: create, boot, erase and delete devices, install and launch apps, simulated pushes without APNs, GPS locations and routes, granting or resetting privacy permissions, openurl deep links, status bar overrides, screenshots and video, os_log streaming, app containers, ",
@@ -2116,7 +2171,7 @@
     },
     {
       "name": "swiftui-animation",
-      "description": "SwiftUI motion: withAnimation, scoped implicit .animation(_:body:) and .animation(_:value:), timing curves and springs (.smooth, .snappy, .bouncy, Spring), PhaseAnimator, KeyframeAnimator, @Animatable, matchedGeometryEffect and matchedTransitionSource zoom transitions, insertion and content transiti",
+      "description": "SwiftUI motion: withAnimation, springs, PhaseAnimator, KeyframeAnimator, matched geometry and zoom transitions, scrollTransition and visualEffect, custom transitions, Reduce Motion. Use when implementing, reviewing or improving SwiftUI animations, transitions or scroll-linked effects.",
       "platform": null,
       "group": "external",
       "plugin": "ai-ios-toolkit",
@@ -2127,7 +2182,7 @@
     },
     {
       "name": "swiftui-expert-skill",
-      "description": "Write, review, or improve SwiftUI code following best practices for state management, view composition, performance, macOS-specific APIs, and iOS 26+ Liquid Glass adoption. Use when building new SwiftUI features, refactoring existing views, reviewing code quality, or adopting modern SwiftUI patterns",
+      "description": "Write, review, or improve SwiftUI code following best practices for state, view composition, performance, macOS APIs, and iOS 26+ Liquid Glass adoption. Use when building SwiftUI features, refactoring views, reviewing code, or adopting modern patterns; for a findings-only review use swiftui-pro; for",
       "platform": null,
       "group": "external",
       "plugin": "ai-ios-toolkit",
@@ -2160,7 +2215,7 @@
     },
     {
       "name": "swiftui-liquid-glass",
-      "description": "Liquid Glass in SwiftUI (iOS 26+): glassEffect, Glass tint/interactive variants, GlassEffectContainer, glassEffectID morphing, glassEffectUnion, GlassEffectTransition, glass and glassProminent button styles, glass toolbars and tab bars, ToolbarSpacer, scrollEdgeEffectStyle, backgroundExtensionEffect",
+      "description": "Liquid Glass in SwiftUI and UIKit: navigation-layer use, regular versus clear, glassEffect, GlassEffectContainer, morphing, glass buttons, ConcentricRectangle, the compatibility opt-out and material fallbacks. Use when implementing, reviewing or adopting Liquid Glass, or choosing glass versus a mate",
       "platform": null,
       "group": "external",
       "plugin": "ai-ios-toolkit",
@@ -2182,7 +2237,7 @@
     },
     {
       "name": "swiftui-patterns",
-      "description": "SwiftUI Model-View structure: @Observable ownership, @State, @Bindable, @Environment, view decomposition, custom ViewModifiers, .task loading, iOS 26 APIs, Writing Tools. Use when structuring a SwiftUI app, managing state, composing or splitting views, or adopting iOS 26 APIs. Not for file-by-file r",
+      "description": "SwiftUI architecture, state: @Observable, @State, @Bindable, @Environment, view splitting, ViewModifiers, .task, API migration, Writing Tools, Transferable, sharing. Use when structuring an app or owning state. Not for review (swiftui-pro) or visual design (hig-foundations).",
       "platform": null,
       "group": "external",
       "plugin": "ai-ios-toolkit",

package/pipeline/skills/shared/README.md

@@ -2,12 +2,12 @@
 
 Single source of truth for skills delivered to both Claude Code (`~/.claude/skills/`) and Copilot CLI (`~/.copilot/skills/`) by the installer.
 
-**Total:** 223 skills (67 core + 156 external). Auto-generated by `scripts/gen-skills-index.mjs`  -  do not edit by hand.
+**Total:** 228 skills (67 core + 161 external). Auto-generated by `scripts/gen-skills-index.mjs`  -  do not edit by hand.
 
 ## Directory layout
 
 - **`core/`**  -  67 `multi-agent*` orchestration skills that are pipeline-critical. Edits here are core-code changes.
-- **`external/`**  -  156 iOS / Android / generic skills that ship into the stack plugins. Each names its origin in `metadata.source`: `multi-agent-pipeline` when written here, or the upstream and license a `NOTICE-*.md` in this directory covers.
+- **`external/`**  -  161 iOS / Android / generic skills that ship into the stack plugins. Each names its origin in `metadata.source`: `multi-agent-pipeline` when written here, or the upstream and license a `NOTICE-*.md` in this directory covers.
 - Install destinations (ADR-0009): Claude Code gets NO local copy of `external/` - it loads those skills from the `multi-agent-plugins` marketplace, namespaced (`ai-<stack>-toolkit:<name>`); only the two compliance catalogs from `core/` land in `~/.claude/skills/`. Copilot CLI and Codex CLI receive a flat copy filtered to the enabled stacks. `external/` remains the single authoring source that `build-stack-plugins.mjs` publishes from.
 
 Source layout is logical grouping only  -  skill discovery at runtime is unchanged.
@@ -15,7 +15,7 @@ Source layout is logical grouping only  -  skill discovery at runtime is unchang
 ## Categories
 
 - [Pipeline Orchestration](#pipeline-orchestration)  -  67
-- [iOS / Apple Ecosystem](#ios-apple-ecosystem)  -  89
+- [iOS / Apple Ecosystem](#ios-apple-ecosystem)  -  94
 - [Android / Kotlin](#android-kotlin)  -  16
 - [Web](#web)  -  10
 - [Backend / API](#backend-api)  -  11
@@ -119,23 +119,28 @@ Source layout is logical grouping only  -  skill discovery at runtime is unchang
 | [`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` | HealthKit on iOS, iPadOS, watchOS and visionOS: HKHealthStore authorization, sample, statistics and chart-ready collection queries, saving H |
+| [`hig-app-icons`](./external/hig-app-icons/) | `external` | iOS app icons: Icon Composer layered icons, default, dark, clear and tinted appearances, asset catalogs, alternate icons and the archive che |
 | [`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-layout`](./external/hig-components-layout/) | `external` | Apple HIG app structure mapped to SwiftUI: tab bars, sidebars, split views, toolbars, sheets and popovers, including the iOS 26 and 27 tab a |
 | [`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 |
 | [`hig-components-system`](./external/hig-components-system/) | `external` | Apple HIG for system surfaces: widgets, controls, Live Activities, Dynamic Island, notifications, complications, quick actions, App Shortcut |
-| [`hig-foundations`](./external/hig-foundations/) | `external` | Apple HIG foundations mapped to SwiftUI: Dynamic Type, semantic color, contrast, safe areas, SF Symbols, materials and Liquid Glass, motion, |
-| [`hig-inputs`](./external/hig-inputs/) | `external` | Apple HIG for input mapped to SwiftUI: touch gestures, keyboards, pointer, Apple Pencil, focus and game controllers, Digital Crown, eyes and |
-| [`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-foundations`](./external/hig-foundations/) | `external` | Apple HIG foundations mapped to SwiftUI: typography and Dynamic Type, semantic color, contrast, spacing, safe areas, touch targets, motion a |
+| [`hig-inputs`](./external/hig-inputs/) | `external` | Apple HIG for input mapped to SwiftUI: gestures, keyboards, pointer, Apple Pencil, focus, game controllers and Digital Crown. Use when desig |
+| [`hig-patterns`](./external/hig-patterns/) | `external` | Apple HIG interaction patterns mapped to SwiftUI: onboarding, permission requests, loading, empty and error states, modality, search, settin |
+| [`hig-platforms`](./external/hig-platforms/) | `external` | Apple HIG per platform: iPhone, iPad, Mac, Watch, TV and Vision Pro, iPad size classes and windowing. Use when a design has to fit a specifi |
 | [`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` | 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-accessibility`](./external/ios-accessibility/) | `external` | VoiceOver, Voice Control, Switch Control and Full Keyboard Access in SwiftUI, UIKit and AppKit: labels, traits, grouping, focus restore, Dyn |
 | [`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-design-review`](./external/ios-design-review/) | `external` | Design critique and screenshot-based visual QA of iOS screens against the HIG, checked across light and dark, Dynamic Type, RTL, contrast an |
+| [`ios-haptics`](./external/ios-haptics/) | `external` | Haptic feedback on iPhone: when a haptic adds meaning, sensoryFeedback, the UIFeedbackGenerator family, Core Haptics and AHAP, settings and  |
+| [`ios-iphone-duo`](./external/ios-iphone-duo/) | `external` | Readiness for iPhone Duo, the foldable two-display iPhone on iOS 27.1: fixed-assumption hunting, asymmetric safe areas, reserved regions, Ar |
 | [`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` | 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-sf-symbols`](./external/ios-sf-symbols/) | `external` | SF Symbols in SwiftUI and UIKit: rendering modes, variable values, symbol effects including Draw On and Off, matching weight and scale to te |
 | [`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 |
@@ -168,13 +173,13 @@ Source layout is logical grouping only  -  skill discovery at runtime is unchang
 | [`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` | 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-animation`](./external/swiftui-animation/) | `external` | SwiftUI motion: withAnimation, springs, PhaseAnimator, KeyframeAnimator, matched geometry and zoom transitions, scrollTransition and visualE |
+| [`swiftui-expert-skill`](./external/swiftui-expert-skill/) | `external` | Write, review, or improve SwiftUI code following best practices for state, view composition, performance, macOS APIs, and iOS 26+ Liquid Gla |
 | [`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-liquid-glass`](./external/swiftui-liquid-glass/) | `external` | Liquid Glass in SwiftUI and UIKit: navigation-layer use, regular versus clear, glassEffect, GlassEffectContainer, morphing, glass buttons, C |
 | [`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-patterns`](./external/swiftui-patterns/) | `external` | SwiftUI architecture, state: @Observable, @State, @Bindable, @Environment, view splitting, ViewModifiers, .task, API migration, Writing Tool |
 | [`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 |

package/pipeline/skills/shared/core/multi-agent-setup/SKILL.md

@@ -136,8 +136,8 @@ Then, **whether they pasted or skipped**, run:
 node "$HOME/.copilot/scripts/usage-register.mjs" --json
 ```
 
-If its JSON line says `"needsPersonalAccount":true`, offer to tie this machine to
-the person's own GitHub account once (the "Personal account" step in
+If its JSON line says `"needsPersonalAccount":true`, offer once: `gh auth login`,
+or an SSH key on the personal account (the "Personal account" step in
 `$HOME/.claude/multi-agent-refs/features/usage-reporting.md`).
 
 It maps whatever token exists and switches reporting on, and requests a

package/pipeline/skills/shared/core/multi-agent-update/SKILL.md

@@ -44,8 +44,8 @@ Update the pipeline with a single command. Preferences are preserved; only skill
    already onboarded, and permanently blocked by `usageLog.optOut: true`. Offline
    or endpoint down leaves reporting off with one line, never an error. Contract:
    `$HOME/.claude/multi-agent-refs/features/usage-reporting.md`.
-   If its JSON line says `"needsPersonalAccount":true`, offer to tie this machine to
-   the person's own GitHub account once (the "Personal account" step in
+   If its JSON line says `"needsPersonalAccount":true`, offer once: `gh auth login`,
+   or an SSH key on the personal account (the "Personal account" step in
    `$HOME/.claude/multi-agent-refs/features/usage-reporting.md`).
 6. Show the new version + changelog
 7. Smoke test (schema + cross-cli)

package/pipeline/skills/shared/external/NOTICE-avdlee-swiftui-agent-skill.md

@@ -17,7 +17,9 @@
 
 - Punctuation normalized to ASCII per pipeline humanizer policy (em-dash, en-dash, ellipsis, curly quotes).
 - Frontmatter `metadata.source` is added.
-- Frontmatter `description`: the upstream text is kept and a boundary clause is appended naming the skill to use for a findings-only review (swiftui-pro). The body is unchanged.
+- Frontmatter `description`: the upstream text is condensed and a boundary clause is appended naming the skills to use for a findings-only review (swiftui-pro) and for Liquid Glass APIs (swiftui-liquid-glass).
+- `references/liquid-glass.md` and the animation references are trimmed to the parts the pipeline's own `swiftui-liquid-glass` and `swiftui-animation` skills do not cover, each with a pointer to that skill and a "Local trim" note at the top.
+- `SKILL.md`: the Liquid Glass rule, the topic-table row and the reference-list entries for the trimmed files name `swiftui-liquid-glass` / `swiftui-animation`.
 
 ## License (MIT, redistributed)
 

package/pipeline/skills/shared/external/NOTICE-dimillian-skills.md

@@ -30,9 +30,10 @@ Upstream `agents/` directories (Claude Code subagent definitions) are not vendor
 
 - Punctuation normalized to ASCII per pipeline humanizer policy (em-dash, en-dash, ellipsis, curly quotes).
 - Each SKILL.md carries a locally added `## When to Use` section and pipeline frontmatter under `metadata:` (`risk`, `source`, `date_added`).
-- `swiftui-ui-patterns/references/components-index.md`: four upstream lines pointing at files that do not exist upstream either (`webview.md`, `composer.md`, `text-input.md`, `design-system.md`) were removed.
+- `swiftui-ui-patterns/references/components-index.md`: four upstream lines pointing at files that do not exist upstream either (`webview.md`, `composer.md`, `text-input.md`, `design-system.md`) were removed, and the haptics line points to the pipeline's `ios-haptics` skill.
 - `macos-spm-app-packaging/SKILL.md`: a trailing fetch transcript that is not part of the upstream file is removed.
 - `swift-concurrency-expert`, `swiftui-performance-audit`, `swiftui-ui-patterns`: the frontmatter `description` keeps the upstream text and appends a boundary clause naming the neighbouring skill to use instead, so a host choosing among overlapping skills can tell them apart. Bodies are unchanged by this.
+- `swiftui-ui-patterns/references/haptics.md` is reduced to a pointer to the pipeline's `ios-haptics` skill, which owns haptics guidance; the file is kept so existing links resolve.
 - `macos-spm-app-packaging/SKILL.md`: one line added that says when to read `references/scaffold.md`, which the upstream SKILL.md does not link.
 
 ## License (MIT, redistributed)

package/pipeline/skills/shared/external/hig-app-icons/SKILL.md

@@ -0,0 +1,159 @@
+---
+name: hig-app-icons
+description: "iOS app icons: Icon Composer layered icons, default, dark, clear and tinted appearances, asset catalogs, alternate icons and the archive checks icons fail. Use when designing, exporting, wiring up or reviewing an app icon, or diagnosing an icon upload error or rejection."
+metadata:
+  source: multi-agent-pipeline
+  date_added: "2026-10-08"
+---
+
+# App icons
+
+An iOS icon is no longer a stack of PNGs at a dozen sizes. It is a layered
+design that the system renders: it adds the rounded mask, the Liquid Glass
+highlights and refraction, the dark, clear and tinted looks, and every size the
+system needs. The designer's job moves from exporting sizes to giving the
+system good layers.
+
+## What the system expects
+
+| | iOS, iPadOS |
+|---|---|
+| Canvas | 1024x1024 px, square, unmasked (Apple Watch: 1088x1088 px) |
+| Style | Layered: a background plus foreground layers |
+| Appearances | Default, dark, clear light, clear dark, tinted light, tinted dark |
+| Sizes | Generated by the system from the one design |
+| Colour spaces | sRGB, Gray Gamma 2.2, Display P3 |
+
+People choose the Home Screen look (default, dark, clear or tinted). Variants
+you do not design are generated automatically. Provide your own when the
+automatic result loses the idea of the icon, for example when a brand colour
+carries the meaning.
+
+## Icon Composer is the default path
+
+Icon Composer ships with Xcode (Xcode > Open Developer Tool > Icon Composer)
+and as a download from developer.apple.com/icon-composer. One Icon Composer
+file describes the icon for iPhone, iPad, Mac and Apple Watch, in every
+appearance.
+
+1. Draw the layers in any vector tool on the Apple template from Apple Design
+   Resources. Separate anything you may want to restyle per appearance.
+   Convert text to outlines. Leave out blurs, shadows, highlights, background
+   fills and the corner mask; Icon Composer and the system add those.
+2. Export layers as SVG; use PNG only for art SVG cannot express (mesh
+   gradients, raster artwork).
+3. In Icon Composer, import the layers, organise them into at most four
+   groups (the groups become the depth layers), set the background as a solid
+   colour or gradient, and tune Liquid Glass per group: specular, blur,
+   translucency, shadow, refraction.
+4. Preview default, dark and mono (mono covers clear and tinted, light and
+   dark), on each platform, over real wallpapers. Fix variants under Color in
+   the Style inspector.
+5. Add the file to the Xcode project. The App Icon field in the target's
+   General tab must match the file name without extension. This file replaces
+   any `AppIcon` asset catalog for the build.
+
+For deployment targets older than the Liquid Glass releases, Xcode generates
+flat images from the Icon Composer file at build time. If the existing icon
+must keep appearing unchanged on those older releases, keep the asset catalog
+instead. Step-by-step detail and the asset catalog route are in
+`references/icon-workflow.md`.
+
+## Design rules worth enforcing
+
+Each of these comes from the HIG app icon page; the reason is given so a
+review can argue the point instead of citing a rule.
+
+- **Square, unmasked layers.** The system masks the corners; a pre-masked layer
+  breaks the specular edge and leaves jagged corners.
+- **Primary content centred.** Masks and corner adjustments crop the edges.
+- **Clean, hard edges on foreground shapes.** System highlights and shadows
+  read soft edges as mistakes.
+- **No baked effects.** Your shadows and glows are static; the system's react
+  to light and motion, and the two fight.
+- **Simple concept, few shapes.** Detail disappears at small sizes and under
+  glass.
+- **Text only when it is essential.** It cannot be localized or read by
+  VoiceOver and is usually too small.
+- **Same features in every appearance.** Swapping elements per look makes the
+  app hard to find when people change their Home Screen style.
+- **No Apple hardware, no SF Symbols.** Apple product replicas are not allowed
+  in icons, and the SF Symbols terms prohibit symbols (or look-alikes) in app
+  icons and logos. See `ios-sf-symbols`.
+- **No photos or UI screenshots.** They do not survive layering, small sizes
+  or the dark and tinted looks.
+
+## Alternate icons
+
+People can pick another icon from inside the app (a team colour, a seasonal
+look). Each alternate is its own Icon Composer file with its own dark, clear
+and tinted variants, and each goes through App Review.
+
+- List them in the **Alternate App Icon Sets** build setting
+  (`ASSETCATALOG_COMPILER_ALTERNATE_APPICON_NAMES`); the primary is the
+  **Primary App Icon Set Name**. Xcode writes `CFBundleIcons`,
+  `CFBundlePrimaryIcon` and `CFBundleAlternateIcons` into Info.plist from
+  those settings, so do not edit those keys by hand.
+- Switch with `UIApplication.setAlternateIconName(_:completionHandler:)`, or
+  its `async throws` form. Pass `nil` to return to the primary icon. Check
+  `supportsAlternateIcons` first and read the current one from
+  `alternateIconName`.
+- The system shows an alert telling the person the icon changed. Trigger the
+  change from an explicit choice in the UI, not on launch or on a timer.
+
+```swift
+import OSLog
+import UIKit
+
+private let logger = Logger(subsystem: "app.icons", category: "alternate")
+
+@MainActor
+func applyIcon(named name: String?) async {
+    let app = UIApplication.shared
+    guard app.supportsAlternateIcons, app.alternateIconName != name else { return }
+    do {
+        try await app.setAlternateIconName(name)
+    } catch {
+        logger.error("Icon change failed: \(error.localizedDescription)")
+    }
+}
+```
+
+## Before upload
+
+Run the archive through `apple-archive-compliance` (the `ios_app_store_audit`
+tool). Its `asset-validation` rule fails an archive with no icon configuration
+or asset catalog. Upload validation (`ios_testflight_validate`) maps the icon
+errors Apple returns:
+
+| Code | Meaning | Usual fix |
+|---|---|---|
+| ITMS-90022 | A required iPhone icon size is missing | Use the Icon Composer file or a Single Size 1024 asset |
+| ITMS-90023 | A required iPad icon size is missing | Add iPad to the Icon Composer file's platforms, or use a Single Size 1024 asset that covers iPad |
+| ITMS-90717 | App Store icon has an alpha channel | Supply an opaque image where a flattened icon is used |
+
+App Review issues that involve icons:
+
+- **2.3.8**: icons, including alternates and in-app purchase icons, must suit
+  a 4+ audience even if the app is rated higher.
+- **4.1**: an icon that copies or impersonates another app.
+- **5.2.5**: an icon confusingly similar to an Apple product or app.
+
+## Reviewing an icon
+
+On a device or in Device Hub, set the Home Screen to dark, clear and tinted
+and look at the icon among system apps and widgets. Ask: is it still
+recognisable in every look, is anything important near the edges, does it
+look crisp at the Settings and notification sizes, and does the dark variant
+keep enough contrast? Coloured backgrounds usually give dark icons the most
+contrast.
+
+## References
+
+- `references/icon-workflow.md`: Icon Composer steps, asset catalog route, alternate icon setup, review checklist.
+- HIG app icons: https://developer.apple.com/design/human-interface-guidelines/app-icons
+- Creating your app icon using Icon Composer: https://developer.apple.com/documentation/xcode/creating-your-app-icon-using-icon-composer
+- Configuring your app icon using an asset catalog: https://developer.apple.com/documentation/xcode/configuring-your-app-icon
+- Alternate app icons sample: https://developer.apple.com/documentation/xcode/configuring-your-app-to-use-alternate-app-icons
+- setAlternateIconName: https://developer.apple.com/documentation/uikit/uiapplication/setalternateiconname(_:completionhandler:)
+- Icon Composer: https://developer.apple.com/icon-composer/

package/pipeline/skills/shared/external/hig-app-icons/evals/evals.json

@@ -0,0 +1,48 @@
+{
+  "skill_name": "hig-app-icons",
+  "evals": [
+    {
+      "id": 0,
+      "name": "migrate-legacy-icon-set",
+      "prompt": "Our app still ships an AppIcon asset catalog with 18 hand-exported PNG sizes and a separate dark PNG. Design wants the new Liquid Glass look. What exactly do we hand over from the design tool, what happens in Icon Composer, and how do we wire it into Xcode without breaking users on older iOS?",
+      "expected_output": "Explains that iOS now uses one layered 1024x1024 design that the system renders at every size and appearance. Design exports square, unmasked layers as SVG (PNG only where needed) with text outlined and no baked blurs, shadows, highlights, background fills or mask. Icon Composer: import, organise into at most four groups, set background, tune Liquid Glass, preview default, dark and mono (clear and tinted). Xcode: add the file and make the App Icon field match its name; it replaces the asset catalog, and Xcode generates flat images for older deployment targets, or keep the asset catalog if the old icon must stay unchanged on older releases.",
+      "files": [],
+      "expectations": [
+        "States sizes are generated from one 1024x1024 design rather than hand-exported",
+        "Asks for unmasked square layers exported as SVG without baked effects",
+        "Mentions grouping into at most four groups in Icon Composer",
+        "Covers default, dark, clear and tinted appearances",
+        "Says the App Icon name in the target must match the Icon Composer file",
+        "Explains older-release behaviour (generated images, or keeping the asset catalog)"
+      ]
+    },
+    {
+      "id": 1,
+      "name": "alternate-icons-setup",
+      "prompt": "Product wants users to pick between three team-colour icons from our settings screen. How do we set that up in Xcode and Swift, and will App Review care?",
+      "expected_output": "One Icon Composer file per alternate, each with its own dark, clear and tinted variants. Lists them in the Alternate App Icon Sets build setting (ASSETCATALOG_COMPILER_ALTERNATE_APPICON_NAMES) and leaves CFBundleIcons keys to Xcode. Calls setAlternateIconName from the person's choice after checking supportsAlternateIcons, passes nil for the primary, reads alternateIconName, handles the error, and notes the system alert. Notes each alternate goes through App Review, must suit 4+ (2.3.8) and must not resemble another app or Apple product.",
+      "files": [],
+      "expectations": [
+        "Uses one Icon Composer file per alternate with its own appearance variants",
+        "Names the Alternate App Icon Sets setting or ASSETCATALOG_COMPILER_ALTERNATE_APPICON_NAMES",
+        "Warns against editing CFBundleIcons by hand",
+        "Uses setAlternateIconName with supportsAlternateIcons and nil for the primary",
+        "Mentions that alternate icons are reviewed by App Review"
+      ]
+    },
+    {
+      "id": 2,
+      "name": "upload-error-and-design-critique",
+      "prompt": "Upload failed with ITMS-90717 on our App Store icon, and while we are at it, the designer put a gear SF Symbol and the word 'Pro' on the icon with a drop shadow. What is wrong?",
+      "expected_output": "Explains ITMS-90717 as an alpha channel in the App Store icon and that a flattened icon must be opaque, and suggests running the archive through apple-archive-compliance or ios_app_store_audit and validation. Critiques the design: SF Symbols terms prohibit symbols in app icons, text should be avoided unless essential, and baked shadows conflict with system effects.",
+      "files": [],
+      "expectations": [
+        "Identifies ITMS-90717 as an alpha channel problem",
+        "Points to apple-archive-compliance or ios_app_store_audit for archive checks",
+        "Says SF Symbols may not be used in app icons",
+        "Advises against nonessential text in the icon",
+        "Says to remove the baked drop shadow and let the system apply effects"
+      ]
+    }
+  ]
+}

package/pipeline/skills/shared/external/hig-app-icons/evals/trigger-eval.json

@@ -0,0 +1,22 @@
+[
+  { "query": "How do I make our app icon with Icon Composer for iOS 26?", "should_trigger": true },
+  { "query": "Do I still need to export all the app icon sizes by hand?", "should_trigger": true },
+  { "query": "Add dark and tinted variants to our app icon", "should_trigger": true },
+  { "query": "Let users choose an alternate app icon from settings", "should_trigger": true },
+  { "query": "setAlternateIconName returns an error, what's wrong with our setup?", "should_trigger": true },
+  { "query": "App Store upload failed with ITMS-90022 missing icon size", "should_trigger": true },
+  { "query": "Review our new app icon design against Apple guidelines", "should_trigger": true },
+  { "query": "What does the clear app icon appearance look like and do we need to design it?", "should_trigger": true },
+  { "query": "Our icon looks jagged at the corners after the Liquid Glass update", "should_trigger": true },
+  { "query": "Where do I set the alternate app icon names in build settings?", "should_trigger": true },
+  { "query": "Which SF Symbol should I use for the settings tab?", "should_trigger": false },
+  { "query": "Make our toolbar buttons use Liquid Glass", "should_trigger": false },
+  { "query": "Generate App Store screenshots in five languages", "should_trigger": false },
+  { "query": "Our archive fails privacy manifest checks before submission", "should_trigger": false },
+  { "query": "Create a custom SF Symbol and annotate its layers", "should_trigger": false },
+  { "query": "Design a launch screen storyboard", "should_trigger": false },
+  { "query": "Improve our App Store listing keywords and subtitle", "should_trigger": false },
+  { "query": "Add images with dark mode variants to the asset catalog", "should_trigger": false },
+  { "query": "Design review of the home screen layout in dark mode", "should_trigger": false },
+  { "query": "Show a badge count on the app icon for unread messages", "should_trigger": false }
+]