@mmerterden/multi-agent-pipeline 8.6.0

package/pipeline/skills/shared/external/help-skills/SKILL.md

@@ -0,0 +1,166 @@
+---
+name: help-skills
+description: Mevcut tum iOS/Swift skill'lerini listeler ve ne ise yaradiklarini aciklar.
+risk: safe
+---
+
+# Skill Rehberi
+
+Kullaniciya mevcut skill'leri kategorize ederek goster. Asagidaki listeyi oku ve kullaniciya sun.
+
+---
+
+## Paul Hudson & AvdLee (Detayli Paketler - reference dosyalari icerir)
+
+| Skill | Konum | Aciklama |
+|---|---|---|
+| **swiftui-pro** | `~/.claude/skills/swiftui-pro/` | SwiftUI code review: deprecated API tespiti, erisilebilirlik, performans, modern API kullanimi. 9 reference dosyasi (accessibility, api, design, hygiene, navigation, performance, data, swift, views) |
+| **swiftdata-pro** | `~/.claude/skills/swiftdata-pro/` | SwiftData best practices: @Model, predicates, CloudKit sync, indexing, class inheritance. 5 reference dosyasi |
+| **swift-concurrency-pro** | `~/.claude/skills/swift-concurrency-pro/` | Swift concurrency review: async/await, actors, Sendable, bridging, diagnostics, bug patterns. 12 reference dosyasi |
+| **swift-testing-pro** | `~/.claude/skills/swift-testing-pro/` | Swift Testing framework: test yazma, XCTest migration, async test patterns. 5 reference dosyasi |
+| **swiftui-expert-skill** | `~/.claude/skills/swiftui-expert-skill/` | State management, Liquid Glass, macOS, animations, charts, accessibility. 19 reference dosyasi (AvdLee) |
+
+---
+
+## Antigravity Skills (Tek Dosya)
+
+### SwiftUI & Swift
+| Skill | Dosya | Aciklama |
+|---|---|---|
+| SwiftUI UI Patterns | `swiftui-ui-patterns.md` | State ownership, navigation, anti-patterns, 6-adim view workflow |
+| SwiftUI View Refactor | `swiftui-view-refactor.md` | View ordering, MV vs MVVM, subview extraction, 300+ satir view bolme |
+| SwiftUI Performance Audit | `swiftui-performance-audit.md` | Invalidation storms, unstable identity, heavy body, layout thrash teshisi |
+| SwiftUI Liquid Glass | `swiftui-liquid-glass.md` | iOS 26+ glassEffect, GlassEffectContainer, fallback patterns |
+| Swift Concurrency Expert | `swift-concurrency-expert.md` | Actor isolation, Sendable, @MainActor, Swift 6.2+ fix stratejileri |
+
+### iOS Development
+| Skill | Dosya | Aciklama |
+|---|---|---|
+| iOS Developer | `ios-developer.md` | Genel iOS: Swift 6, SwiftUI, Core Data, URLSession, XCTest, Fastlane |
+| iOS Debugger Agent | `ios-debugger-agent.md` | XcodeBuildMCP ile simulator build/run/debug, UI interaction, log capture |
+
+### Apple HIG (Human Interface Guidelines)
+| Skill | Dosya | Aciklama |
+|---|---|---|
+| HIG Foundations | `hig-foundations.md` | Temel ilkeler: erisilebilirlik, renk, tipografi, motion, privacy |
+| HIG Patterns | `hig-patterns.md` | Modality, feedback, onboarding, search, undo, progressive disclosure |
+| HIG Components Layout | `hig-components-layout.md` | Tab bar, sidebar, navigation, multi-column, adaptive layout |
+| HIG Components Content | `hig-components-content.md` | Charts, collections, image views, web views, activity views |
+| HIG Components Status | `hig-components-status.md` | Progress indicator, status bar, activity rings |
+| HIG Components System | `hig-components-system.md` | Widget, Live Activity, Dynamic Island, Notification, App Clip |
+| HIG Inputs | `hig-inputs.md` | Touch, Apple Pencil, keyboard, game controller, Digital Crown |
+| HIG Platforms | `hig-platforms.md` | iOS/iPadOS/macOS/tvOS/visionOS/watchOS platform farklari |
+| HIG Technologies | `hig-technologies.md` | Siri, Apple Pay, HealthKit, ARKit, CarPlay, Sign in with Apple |
+
+### App Store & Diger
+| Skill | Dosya | Aciklama |
+|---|---|---|
+| App Store Optimization | `app-store-optimization.md` | ASO: keyword analizi, metadata, screenshot, rating yonetimi |
+| App Store Changelog | `app-store-changelog.md` | Git history'den App Store release notes uretme |
+| Firebase | `firebase.md` | Auth, Firestore, Cloud Functions, security rules, emulators |
+| Accessibility Audit | `accessibility-compliance-accessibility-audit.md` | WCAG, VoiceOver, Dynamic Type, inkluzif tasarim denetimi |
+| macOS Menubar Tuist | `macos-menubar-tuist-app.md` | macOS menubar app gelistirme (Tuist workflow) |
+| macOS SPM Packaging | `macos-spm-app-packaging.md` | SwiftPM ile macOS app build/sign/notarize/package |
+
+---
+
+## dpearson2699 iOS Skills (57 Skill)
+
+Konum: `~/.claude/skills/ios-skills/<skill-adi>/SKILL.md`
+
+### SwiftUI (9)
+| Skill | Aciklama |
+|---|---|
+| `swiftui-animation` | Animasyonlar, transitions, symbol effects |
+| `swiftui-gestures` | Tap, drag, magnify, rotate, gesture composition |
+| `swiftui-layout-components` | Stacks, grids, lists, forms, search |
+| `swiftui-liquid-glass` | Liquid Glass effects (iOS 26+) |
+| `swiftui-navigation` | NavigationStack, sheets, tabs, deep links |
+| `swiftui-patterns` | MV architecture, state management, composition |
+| `swiftui-performance` | Performans audit ve optimizasyon |
+| `swiftui-uikit-interop` | UIViewRepresentable, UIHostingController |
+| `swiftui-webkit` | WebView ve WebPage (iOS 26+) |
+
+### Core Swift (6)
+| Skill | Aciklama |
+|---|---|
+| `swift-codable` | JSON encoding/decoding patterns |
+| `swift-charts` | Swift Charts ile veri gorsellestirme |
+| `swift-concurrency` | async/await, actors, Sendable, structured concurrency |
+| `swift-language` | Modern Swift patterns (expressions, typed throws) |
+| `swift-testing` | Swift Testing framework |
+| `swiftdata` | SwiftData: @Model, @Query, persistence |
+
+### App Experience (8)
+| Skill | Aciklama |
+|---|---|
+| `alarmkit` | AlarmKit alarm ve countdown timer |
+| `app-clips` | Lightweight instant app experiences |
+| `app-intents` | Siri, Shortcuts, Spotlight, widgets, Apple Intelligence |
+| `live-activities` | Lock Screen, Dynamic Island, push updates |
+| `mapkit-location` | Maps, CoreLocation, geocoding, directions |
+| `storekit` | StoreKit 2 in-app purchase ve subscriptions |
+| `tipkit` | Feature discovery tips ve onboarding |
+| `widgetkit` | Home screen widgets, Lock Screen, controls |
+
+### AI/ML (5)
+| Skill | Aciklama |
+|---|---|
+| `apple-on-device-ai` | Foundation Models, Core ML, MLX Swift, llama.cpp |
+| `coreml` | Core ML model loading, prediction, MLTensor |
+| `natural-language` | NLP, translation, embeddings |
+| `speech-recognition` | Speech-to-text, SpeechAnalyzer |
+| `vision-framework` | OCR, face detection, barcode, segmentation |
+
+### iOS Engineering (10)
+| Skill | Aciklama |
+|---|---|
+| `app-store-review` | App Store review hazirligi ve rejection onleme |
+| `authentication` | Sign in with Apple, OAuth, biometrics |
+| `background-processing` | BGTaskScheduler, background URLSession, push |
+| `debugging-instruments` | LLDB, Memory Graph, Instruments, Time Profiler |
+| `ios-accessibility` | VoiceOver, Dynamic Type, accessibility patterns |
+| `ios-localization` | String Catalogs, FormatStyle, RTL |
+| `ios-networking` | URLSession async/await, API clients |
+| `ios-security` | Keychain, CryptoKit, certificate pinning |
+| `metrickit-diagnostics` | Performance metrics ve crash diagnostics |
+| `device-integrity` | DeviceCheck ve App Attest |
+
+### Hardware (5)
+| Skill | Aciklama |
+|---|---|
+| `core-bluetooth` | BLE central ve peripheral |
+| `core-motion` | Accelerometer, gyroscope, pedometer |
+| `core-nfc` | NFC tag reading ve writing |
+| `pencilkit-drawing` | Apple Pencil, canvas, tool picker |
+| `realitykit-ar` | RealityKit + ARKit augmented reality |
+
+### Platform Entegrasyonlari (14)
+| Skill | Aciklama |
+|---|---|
+| `callkit-voip` | CallKit + PushKit VoIP |
+| `cloudkit-sync` | CloudKit, iCloud sync, CKSyncEngine |
+| `contacts-framework` | Contacts read/write/pick |
+| `energykit` | Grid electricity forecasts |
+| `eventkit-calendar` | Calendar events ve reminders |
+| `healthkit` | Apple Health data read/write/workouts |
+| `homekit-matter` | Smart home accessories ve Matter |
+| `musickit-audio` | Apple Music, MusicKit, MediaPlayer |
+| `passkit-wallet` | Apple Pay ve Wallet passes |
+| `permissionkit` | Child communication safety (iOS 26+) |
+| `photos-camera-media` | PhotosPicker, AVCaptureSession |
+| `push-notifications` | Local/remote notifications, APNs |
+| `shareplay-activities` | GroupActivities / SharePlay |
+| `weatherkit` | Weather forecasts ve attribution |
+
+---
+
+## Nasil Calisir?
+
+Claude bu skill'leri workflow icinde otomatik olarak okur ve uygular. Ornegin:
+- SwiftUI view yazarken → `swiftui-pro/` + `swiftui-expert-skill/` reference'larini kontrol eder
+- Concurrency hatasi varsa → `swift-concurrency-pro/` diagnostics ve bug-patterns'i okur
+- App Store'a submit oncesi → `app-store-review` + `app-store-optimization` kontrol eder
+- StoreKit entegrasyonu → `ios-skills/storekit/SKILL.md` okur
+
+Skill'i manuel tetiklemek icin: "X skill'ini kullanarak review et" veya "StoreKit skill'ine gore implemente et" diyebilirsiniz.

package/pipeline/skills/shared/external/hig-components-content/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: hig-components-content
+description: Apple Human Interface Guidelines for content display components.
+risk: unknown
+source: community
+date_added: '2026-02-27'
+---
+
+# Apple HIG: Content Components
+
+Check for `.claude/apple-design-context.md` before asking questions. Use existing context and only ask for information not already covered.
+
+## Key Principles
+
+1. **Adapt to different sizes and contexts.** Content components must work across screen sizes, orientations, and multitasking configurations. Use Auto Layout and size classes.
+
+2. **Make content accessible.** Charts need audio graph support. Images need alt text. Collections need proper VoiceOver navigation order. All content components need labels and descriptions.
+
+3. **Maintain visual hierarchy.** Use spacing, sizing, and grouping to establish clear information hierarchy. Primary content should be visually prominent.
+
+4. **Use system components first.** Evaluate UICollectionView, SwiftUI Charts, WKWebView before building custom. System components come with built-in accessibility and platform adaptation.
+
+5. **Respect platform conventions.** A collection on tvOS uses large lockups with parallax. The same collection on iOS uses compact cells with touch targets. On visionOS, content gains depth and hover effects.
+
+6. **Handle empty states.** Show a meaningful empty state with guidance on how to populate it, not a blank screen.
+
+7. **Optimize for performance.** Use lazy loading, cell reuse, pagination, and prefetching for large datasets.
+
+## Reference Index
+
+| Reference | Topic | Key content |
+|---|---|---|
+| [charts.md](references/charts.md) | Charts | Swift Charts, bar/line/area/point marks, chart accessibility, audio graphs |
+| [collections.md](references/collections.md) | Collections | Grid/list layouts, compositional layout, selection, reordering, diffable data sources |
+| [image-views.md](references/image-views.md) | Image Views | Aspect ratio handling, content modes, SF Symbol images, accessibility |
+| [image-wells.md](references/image-wells.md) | Image Wells | Drag-and-drop image selection, macOS-specific, placeholder content |
+| [color-wells.md](references/color-wells.md) | Color Wells | Color selection UI, system color picker, custom color spaces |
+| [web-views.md](references/web-views.md) | Web Views | WKWebView, SFSafariViewController, navigation controls, content restrictions |
+| [activity-views.md](references/activity-views.md) | Activity Views | Share sheets, activity items, custom activities, action extensions |
+| [lockups.md](references/lockups.md) | Lockups | Image+text elements, tvOS card layouts, focus effects, shelf layouts |
+
+## Component Selection Guide
+
+| Content Need | Recommended Component | Platform Notes |
+|---|---|---|
+| Visualizing quantitative data | Charts (Swift Charts) | iOS 16+, macOS 13+, watchOS 9+ |
+| Browsing a grid or list of items | Collection View | Compositional layout for complex arrangements |
+| Displaying a single image | Image View | Support aspect ratio fitting; provide accessibility description |
+| Selecting an image via drag or browse | Image Well | macOS primarily; use image pickers on iOS |
+| Selecting a color | Color Well | Triggers system color picker; macOS, iOS 14+ |
+| Showing web content inline | Web View (WKWebView) | Use SFSafariViewController for external browsing |
+| Sharing content to other apps | Activity View | System share sheet with configurable activity types |
+| Content card (image + text) | Lockup | Primarily tvOS; adaptable to other platforms |
+
+## Output Format
+
+1. **Component recommendation with rationale**, referencing the relevant HIG reference file.
+2. **Configuration guidance** -- key properties and setup.
+3. **Accessibility requirements** for the recommended component.
+4. **Platform-specific notes** for targeted platforms.
+
+## Questions to Ask
+
+1. What type of content? (Quantitative data, images, web content, browsable collection, share action?)
+2. Which platforms?
+3. Static or dynamic content?
+4. How much content? (Few items vs hundreds/thousands affects component choice and optimization.)
+
+## Related Skills
+
+- **hig-foundations** -- Color, typography, accessibility, and image guidelines
+- **hig-patterns** -- Data visualization, sharing, and loading patterns
+- **hig-components-layout** -- Structural containers (scroll views, lists, split views) hosting content
+- **hig-platforms** -- Platform-specific component behavior (lockups on tvOS, web views on macOS)
+
+---
+
+*Built by [Raintree Technology](https://raintree.technology) · [More developer tools](https://raintree.technology)*
+
+## When to Use
+This skill is applicable to execute the workflow or actions described in the overview.

package/pipeline/skills/shared/external/hig-components-layout/SKILL.md

@@ -0,0 +1,95 @@
+---
+name: hig-components-layout
+description: Apple Human Interface Guidelines for layout and navigation components.
+risk: unknown
+source: community
+date_added: '2026-02-27'
+---
+
+# Apple HIG: Layout and Navigation Components
+
+Check for `.claude/apple-design-context.md` before asking questions. Use existing context and only ask for information not already covered.
+
+## Key Principles
+
+1. **Organize hierarchically.** Structure information from broad categories to specific details. Sidebars for top-level sections, lists for browsable items, detail views for individual content.
+
+2. **Use standard navigation patterns.** Tab bars for flat navigation between peer sections (iPhone). Sidebars for deep hierarchical navigation (iPad, Mac). Match the pattern to the information architecture and platform.
+
+3. **Adapt to screen size.** Three-column on iPad collapses to single-column on iPhone. Use size classes and adaptive APIs (NavigationSplitView) for automatic adaptation.
+
+4. **Support multitasking on iPad.** Respond gracefully to Split View, Slide Over, and Stage Manager. Test at every split ratio and size class transition.
+
+5. **Maintain spatial consistency on visionOS.** Windows, volumes, and ornaments in shared space. Position predictably. Use ornaments for toolbars and controls without occluding content.
+
+6. **Use scroll views for overflow content.** Enable paging for discrete content units. Support pull-to-refresh where appropriate. Respect safe areas.
+
+7. **Keep navigation predictable.** Users should always know where they are, how they got there, and how to go back. Use back buttons, breadcrumbs, and clear section titles.
+
+8. **Prefer system components.** UINavigationController, UISplitViewController, NavigationSplitView, and TabView provide built-in adaptivity, accessibility, and state restoration.
+
+## Reference Index
+
+| Reference | Topic | Key content |
+|---|---|---|
+| [sidebars.md](references/sidebars.md) | Sidebars | Source lists, selection state, collapsible sections, iPad/Mac patterns |
+| [column-views.md](references/column-views.md) | Column Views | Finder-style browsing, progressive disclosure through columns |
+| [outline-views.md](references/outline-views.md) | Outline Views | Expandable hierarchies, disclosure triangles, tree structures |
+| [split-views.md](references/split-views.md) | Split Views | Two/three column layouts, NavigationSplitView, adaptive collapse |
+| [tab-views.md](references/tab-views.md) | Tab Views | Segmented tabs, page-style tabs, macOS tab grouping |
+| [tab-bars.md](references/tab-bars.md) | Tab Bars | Bottom tab bars (iOS), badge counts, max tab count |
+| [scroll-views.md](references/scroll-views.md) | Scroll Views | Paging, scroll indicators, content insets, pull-to-refresh |
+| [windows.md](references/windows.md) | Windows | macOS/visionOS window management, sizing, full-screen, restoration |
+| [panels.md](references/panels.md) | Panels | Inspector panels, utility panels, floating panels, macOS conventions |
+| [lists-and-tables.md](references/lists-and-tables.md) | Lists and Tables | Plain/grouped/inset-grouped styles, swipe actions, section headers |
+| [boxes.md](references/boxes.md) | Boxes | Content grouping containers, labeled boxes, macOS grouping |
+| [ornaments.md](references/ornaments.md) | Ornaments | visionOS toolbar attachments, positioning, visibility |
+
+## Navigation Pattern Selection
+
+| App Structure | Recommended Pattern | Platform Adaptation |
+|---|---|---|
+| 3-5 peer top-level sections | Tab Bar | iPhone: bottom tab bar. iPad: sidebar (`.sidebarAdaptable`, iPadOS 18+). Mac: sidebar or toolbar tabs |
+| Deep hierarchical content | Sidebar + NavigationSplitView | iPhone: single column stack. iPad: two/three columns. Mac: full multi-column |
+| Deep file/folder tree | Column View | Mac: Finder-style. iPad: adaptable. iPhone: push navigation |
+| Flat list with detail | Split View (two column) | iPhone: push/pop stack. iPad/Mac: primary + detail columns |
+| Document-based with inspectors | Window + Panels | Mac: main window with inspector. iPad: sheet or popover |
+| Spatial app with tools | Window + Ornaments | visionOS: ornaments on window. Other platforms: toolbars |
+
+## Layout Adaptation Checklist
+
+- [ ] **Compact width (iPhone portrait):** Navigation collapses to single stack? Tab bars visible?
+- [ ] **Regular width (iPad landscape, Mac):** Navigation expands to sidebar + detail? Space used well?
+- [ ] **Multitasking (iPad):** Adapts at every split ratio? Works in Slide Over?
+- [ ] **Accessibility:** Supports Dynamic Type at all sizes? VoiceOver order logical?
+- [ ] **Orientation:** Content reflows between portrait and landscape?
+- [ ] **visionOS:** Windows positioned ergonomically? Ornaments accessible? Depth meaningful?
+
+## Output Format
+
+1. **Recommended navigation pattern** with rationale for the app's information architecture.
+2. **Layout hierarchy** from root container down (e.g., TabView > NavigationSplitView > List > Detail).
+3. **Platform adaptation** across targeted platforms and size classes.
+4. **Size class behavior** at each transition.
+
+## Questions to Ask
+
+1. What is the app's information architecture? (Sections, hierarchy depth, top-level categories?)
+2. How many top-level sections?
+3. Which platforms?
+4. Need multitasking on iPad?
+5. SwiftUI or UIKit?
+
+## Related Skills
+
+- **hig-foundations** -- Layout spacing, margins, safe areas, alignment
+- **hig-platforms** -- Platform-specific navigation conventions
+- **hig-patterns** -- Multitasking, full-screen, and launching patterns
+- **hig-components-content** -- Content displayed within layout containers
+
+---
+
+*Built by [Raintree Technology](https://raintree.technology) · [More developer tools](https://raintree.technology)*
+
+## When to Use
+This skill is applicable to execute the workflow or actions described in the overview.

package/pipeline/skills/shared/external/hig-components-status/SKILL.md

@@ -0,0 +1,82 @@
+---
+name: hig-components-status
+description: Apple HIG guidance for status and progress UI components including progress indicators, status bars, and activity rings.
+risk: unknown
+source: community
+date_added: '2026-02-27'
+---
+
+# Apple HIG: Status Components
+
+Check for `.claude/apple-design-context.md` before asking questions. Use existing context and only ask for information not already covered.
+
+## Key Principles
+
+### Progress Indicators
+
+1. **Show progress for operations longer than a second or two.**
+
+2. **Determinate when duration/percentage is known.** A filling progress bar gives users a clear sense of remaining work. Use for downloads, uploads, or any measurable process.
+
+3. **Indeterminate when duration is unknown.** A spinner communicates work is happening without promising a timeframe. Use for unpredictable network requests.
+
+4. **Prefer progress bars over spinners.** Determinate progress feels faster and more trustworthy.
+
+5. **Place indicators where content will appear.** Inline progress near the content area, not modal or distant.
+
+6. **Don't stack multiple indicators.** Aggregate simultaneous operations into one representation or show the most relevant.
+
+### Status Bars
+
+7. **Don't hide the status bar without good reason.** Reserve hiding for immersive experiences (full-screen media, games, AR).
+
+8. **Match status bar style to your content.** Light or dark for adequate contrast.
+
+9. **Respect safe areas.** No interactive content behind the status bar.
+
+10. **Restore promptly** when exiting immersive contexts.
+
+### Activity Rings
+
+11. **Activity rings are for Move, Exercise, and Stand goals.** Don't repurpose the ring metaphor for unrelated data.
+
+12. **Respect ring color conventions.** Red (Move), green (Exercise), blue (Stand) are strongly associated with Apple Fitness.
+
+13. **Use HealthKit APIs** for activity data rather than manual tracking.
+
+14. **Celebrate completions** with animation and haptics when rings close.
+
+## Reference Index
+
+| Reference | Topic | Key content |
+|---|---|---|
+| [progress-indicators.md](references/progress-indicators.md) | Progress bars and spinners | Determinate, indeterminate, inline placement, duration |
+| [status-bars.md](references/status-bars.md) | iOS/iPadOS status bar | System info, visibility, style, safe areas |
+| [activity-rings.md](references/activity-rings.md) | watchOS activity rings | Move/Exercise/Stand, HealthKit, fitness tracking, color |
+
+## Output Format
+
+1. **Indicator type recommendation** with rationale (determinate vs indeterminate).
+2. **Timing and animation guidance** -- duration thresholds, animation style, transitions.
+3. **Accessibility** -- VoiceOver progress announcements, live region updates.
+4. **Platform-specific behavior** across targeted platforms.
+
+## Questions to Ask
+
+1. Is the duration known or unknown?
+2. Which platforms?
+3. How long does the operation typically take?
+4. System-level or in-app indicator?
+
+## Related Skills
+
+- **hig-components-system** -- Widgets and complications displaying progress or status
+- **hig-inputs** -- Gestures triggering progress states (pull-to-refresh)
+- **hig-technologies** -- HealthKit for activity ring data; VoiceOver for progress announcements
+
+---
+
+*Built by [Raintree Technology](https://raintree.technology) · [More developer tools](https://raintree.technology)*
+
+## When to Use
+This skill is applicable to execute the workflow or actions described in the overview.

package/pipeline/skills/shared/external/hig-components-system/SKILL.md

@@ -0,0 +1,101 @@
+---
+name: hig-components-system
+description: 'Apple HIG guidance for system experience components: widgets, live activities, notifications, complications, home screen quick actions, top shelf, watch faces, app clips, and app shortcuts.'
+risk: unknown
+source: community
+date_added: '2026-02-27'
+---
+
+# Apple HIG: System Experiences
+
+Check for `.claude/apple-design-context.md` before asking questions. Use existing context and only ask for information not already covered.
+
+## Key Principles
+
+### General
+
+1. **Glanceable, immediate value.** System experiences bring your app's most important content to surfaces the user sees without launching your app. Design for seconds of attention.
+
+2. **Respect platform context.** A Lock Screen widget has different constraints than a Home Screen widget. A complication is far smaller than a top shelf item.
+
+### Widgets
+
+3. **Show relevant information, not everything.** Display the most useful subset, updated appropriately.
+
+4. **Support multiple sizes with distinct layouts.** Each size should be a thoughtful design, not a scaled version of another.
+
+5. **Deep-link on tap.** Take users to the relevant content, not the app's root screen.
+
+### Live Activities
+
+6. **Track events with a clear start and end.** Deliveries, scores, timers, rides. Design for both Dynamic Island and Lock Screen.
+
+7. **Stay updated and timely.** Stale data undermines trust. End promptly when the event concludes.
+
+### Notifications
+
+8. **Respect user attention.** Only send notifications for information users genuinely care about. No promotional or low-value notifications.
+
+9. **Actionable and self-contained.** Include enough context to understand and act without opening the app. Support notification actions. Use threading and grouping.
+
+### Complications
+
+10. **Focused data on the watch face.** Design for the smallest useful representation. Support multiple families. Budget updates wisely.
+
+### Home Screen Quick Actions
+
+11. **3-4 most common tasks.** Short titles, optional subtitles, relevant SF Symbol icons.
+
+### Top Shelf
+
+12. **tvOS showcase.** Feature content that entices: new episodes, featured items, recent content.
+
+### App Clips
+
+13. **Instant, focused functionality within a strict size budget.** Load quickly without App Store download. Only what's needed for the immediate task, then offer full app install.
+
+### App Shortcuts
+
+14. **Surface key actions to Siri and Spotlight.** Define shortcuts for frequent tasks. Use natural, conversational trigger phrases.
+
+## Reference Index
+
+| Reference | Topic | Key content |
+|---|---|---|
+| [widgets.md](references/widgets.md) | Widgets | Glanceable info, sizes, deep linking, timeline |
+| [live-activities.md](references/live-activities.md) | Live Activities | Real-time tracking, Dynamic Island, Lock Screen |
+| [notifications.md](references/notifications.md) | Notifications | Attention, actions, grouping, content |
+| [complications.md](references/complications.md) | Complications | Watch face data, families, budgeted updates |
+| [home-screen-quick-actions.md](references/home-screen-quick-actions.md) | Quick actions | Haptic Touch, common tasks, SF Symbols |
+| [top-shelf.md](references/top-shelf.md) | Top shelf | Featured content, showcase |
+| [app-clips.md](references/app-clips.md) | App Clips | Instant use, lightweight, focused task, NFC/QR |
+| [watch-faces.md](references/watch-faces.md) | Watch faces | Custom complications, face sharing |
+| [app-shortcuts.md](references/app-shortcuts.md) | App Shortcuts | Siri, Spotlight, voice triggers |
+
+## Output Format
+
+1. **System experience recommendation** -- which surface best fits the use case.
+2. **Content strategy** -- what to display, priority, what to omit.
+3. **Update frequency** -- refresh rate including system budget constraints.
+4. **Size/family variants** -- which to support and how layout adapts.
+5. **Deep link behavior** -- where tapping takes the user.
+
+## Questions to Ask
+
+1. What information needs to surface outside the app?
+2. Which platform?
+3. How frequently does the data update?
+4. What is the primary glanceable need?
+
+## Related Skills
+
+- **hig-components-status** -- Progress indicators in widgets or Live Activities
+- **hig-inputs** -- Interaction patterns for system experiences (Digital Crown for complications)
+- **hig-technologies** -- Siri for App Shortcuts, HealthKit for complications, NFC for App Clips
+
+---
+
+*Built by [Raintree Technology](https://raintree.technology) · [More developer tools](https://raintree.technology)*
+
+## When to Use
+This skill is applicable to execute the workflow or actions described in the overview.

package/pipeline/skills/shared/external/hig-foundations/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: hig-foundations
+description: Apple Human Interface Guidelines design foundations.
+risk: unknown
+source: community
+date_added: '2026-02-27'
+---
+
+# Apple HIG: Design Foundations
+
+Check for `.claude/apple-design-context.md` before asking questions. Use existing context and only ask for information not already covered.
+
+## Key Principles
+
+1. **Prioritize content over chrome.** Reduce visual clutter. Use system-provided materials and subtle separators rather than heavy borders and backgrounds.
+
+2. **Build in accessibility from the start.** Design for VoiceOver, Dynamic Type, Reduce Motion, Increase Contrast, and Switch Control from day one. Every interactive element needs an accessible label.
+
+3. **Use system colors and materials.** System colors adapt to light/dark mode, increased contrast, and vibrancy. Prefer semantic colors (`label`, `secondaryLabel`, `systemBackground`) over hard-coded values.
+
+4. **Use platform fonts and icons.** SF Pro, SF Compact, SF Mono by default. New York for serif. Follow the type hierarchy at recommended sizes. Use SF Symbols for iconography.
+
+5. **Match platform conventions.** Align look and behavior with system standards. Provide direct, responsive manipulation and clear feedback for every action.
+
+6. **Respect privacy.** Request permissions only when needed, explain why clearly, provide value before asking for data. Design for minimal data collection.
+
+7. **Support internationalization.** Accommodate text expansion, right-to-left scripts, and varying date/number formats. Use Auto Layout for dynamic content sizing.
+
+8. **Use motion purposefully.** Animation should communicate meaning and spatial relationships. Honor Reduce Motion by providing crossfade alternatives.
+
+## Reference Index
+
+| Reference | Topic | Key content |
+|---|---|---|
+| [accessibility.md](references/accessibility.md) | Accessibility | VoiceOver, Dynamic Type, color contrast, motor accessibility, Switch Control, audio descriptions |
+| [app-icons.md](references/app-icons.md) | App Icons | Icon grid, platform-specific sizes, single focal point, no transparency |
+| [branding.md](references/branding.md) | Branding | Integrating brand identity within Apple's design language, subtle branding, custom tints |
+| [color.md](references/color.md) | Color | System colors, Dynamic Colors, semantic colors, custom palettes, contrast ratios |
+| [dark-mode.md](references/dark-mode.md) | Dark Mode | Elevated surfaces, semantic colors, adapted palettes, vibrancy, testing in both modes |
+| [icons.md](references/icons.md) | Icons | Glyph icons, SF Symbols integration, custom icon design, icon weights, optical alignment |
+| [images.md](references/images.md) | Images | Image resolution, @2x/@3x assets, vector assets, image accessibility |
+| [immersive-experiences.md](references/immersive-experiences.md) | Immersive Experiences | AR/VR design, spatial immersion, comfort zones, progressive immersion levels |
+| [inclusion.md](references/inclusion.md) | Inclusion | Diverse representation, non-gendered language, cultural sensitivity, inclusive defaults |
+| [layout.md](references/layout.md) | Layout | Margins, spacing, alignment, safe areas, adaptive layouts, readable content guides |
+| [materials.md](references/materials.md) | Materials | Vibrancy, blur, translucency, system materials, material thickness |
+| [motion.md](references/motion.md) | Motion | Animation curves, transitions, continuity, Reduce Motion support, physics-based motion |
+| [privacy.md](references/privacy.md) | Privacy | Permission requests, usage descriptions, privacy nutrition labels, minimal data collection |
+| [right-to-left.md](references/right-to-left.md) | Right-to-Left | RTL layout mirroring, bidirectional text, icons that flip, exceptions |
+| [sf-symbols.md](references/sf-symbols.md) | SF Symbols | Symbol categories, rendering modes, variable color, custom symbols, weight matching |
+| [spatial-layout.md](references/spatial-layout.md) | Spatial Layout | visionOS window placement, depth, ergonomic zones, Z-axis design |
+| [typography.md](references/typography.md) | Typography | SF Pro, Dynamic Type sizes, text styles, custom fonts, font weight hierarchy, line spacing |
+| [writing.md](references/writing.md) | Writing | UI copy guidelines, tone, capitalization rules, error messages, button labels, conciseness |
+
+## Applying Foundations Together
+
+Consider how principles interact:
+
+1. **Color + Dark Mode + Accessibility** -- Custom palettes must work in both modes while maintaining WCAG contrast ratios. Start with system semantic colors.
+
+2. **Typography + Accessibility + Layout** -- Dynamic Type must scale without breaking layouts. Use text styles and Auto Layout for the full range of type sizes.
+
+3. **Icons + Branding + SF Symbols** -- Custom icons should match SF Symbols weight and optical sizing. Brand elements should integrate without overriding system conventions.
+
+4. **Motion + Accessibility + Feedback** -- Every animation must have a Reduce Motion alternative. Motion should reinforce spatial relationships, not decorate.
+
+5. **Privacy + Writing + Onboarding** -- Permission requests need clear, specific usage descriptions. Time them to when the user will understand the benefit.
+
+## Output Format
+
+1. **Cite the specific HIG foundation** with file and section.
+2. **Note platform differences** for the user's target platforms.
+3. **Provide concrete code patterns** (SwiftUI/UIKit/AppKit).
+4. **Explain accessibility impact** (contrast ratios, Dynamic Type scaling, VoiceOver behavior).
+
+## Questions to Ask
+
+1. Which platforms are you targeting?
+2. Do you have existing brand guidelines?
+3. What accessibility level are you targeting? (WCAG AA, AAA, Apple baseline?)
+4. System colors or custom?
+
+## Related Skills
+
+- **hig-platforms** -- How foundations apply per platform (e.g., type scale differences on watchOS vs macOS)
+- **hig-patterns** -- Interaction patterns where foundations like writing and accessibility are critical
+- **hig-components-layout** -- Structural components implementing layout principles
+- **hig-components-content** -- Content display using color, typography, and images
+
+---
+
+*Built by [Raintree Technology](https://raintree.technology) · [More developer tools](https://raintree.technology)*
+
+## When to Use
+This skill is applicable to execute the workflow or actions described in the overview.