Individual skill
swiftui-expert-skill
Use when writing, reviewing, or refactoring SwiftUI code for iOS or macOS, including state and `@Observable` data flow, view composition, resizable layouts, safe areas, display scale, performance, lists, environment, localization, animation, Liquid Glass, and API migration. Also use for iPhone Duo, foldable, or large-display layouts (`NavigationSplitView` on large displays, iPhone tab sidebar, two-column reflow, foldable grids, `ArrangementView`, `ReservedRegion`), hinge effects, vertical bars, `@State` initialization or synthesized-property diagnostics, `@ContentBuilder` ambiguity, `reorderable` drag/drop, custom `AsyncImage` `URLSession`, swipe actions outside List, item-bound `alert`/`confirmationDialog`, `ToolbarOverflowMenu`, `AnimatableValues`, Document APIs (`Document`/`DocumentReader`), and Instruments `.trace` capture or analysis.
skills/swiftui-expert-skill/SKILL.md
Source commit 62bd760f005093d1e2e4de5db156e456a5f96400
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- Yes
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Local scripts
- Last checked
- Nov 9, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 3,888
- Repository last updated
- Nov 6, 2026
- License
- MIT
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
SKILL.mdcore · 11,976 bytesSKILL.mdcore · 11,976 bytesSKILL.mdcore · 11,976 bytesSKILL.mdcore · 11,976 bytesSKILL.mdcore · 11,976 bytesSKILL.mdcore · 11,976 bytesSKILL.mdcore · 11,976 bytesSKILL.mdcore · 11,976 bytesSKILL.mdcore · 11,976 bytesagents/openai.yamlasset · 228 bytesassets/logo-small.pngasset · 29,649 bytesassets/logo.pngasset · 398,841 bytesassets/logo.svgasset · 2,006 bytesreferences/accessibility-patterns.mddoc · 6,073 bytesreferences/animation-advanced.mddoc · 11,439 bytesreferences/animation-basics.mddoc · 6,865 bytesreferences/animation-transitions.mddoc · 8,052 bytesreferences/charts-accessibility.mddoc · 6,291 bytesreferences/charts.mddoc · 17,219 bytesreferences/document-apps.mddoc · 11,319 bytesreferences/environment-patterns.mddoc · 7,538 bytesreferences/focus-patterns.mddoc · 8,877 bytesreferences/image-optimization.mddoc · 10,617 bytesreferences/iphone-duo.mddoc · 7,620 bytesreferences/latest-apis.mddoc · 29,530 bytesreferences/layout-best-practices.mddoc · 21,066 bytesreferences/liquid-glass.mddoc · 12,660 bytesreferences/list-patterns.mddoc · 21,013 bytesreferences/localization.mddoc · 9,960 bytesreferences/macos-scenes.mddoc · 9,757 bytesreferences/macos-views.mddoc · 11,027 bytesreferences/macos-window-styling.mddoc · 8,815 bytesreferences/modifier-patterns.mddoc · 2,530 bytesreferences/performance-patterns.mddoc · 11,933 bytesreferences/previews.mddoc · 8,327 bytesreferences/scroll-patterns.mddoc · 10,837 bytesreferences/sheet-navigation-patterns.mddoc · 15,380 bytesreferences/soft-deprecation.mddoc · 3,002 bytesreferences/state-management.mddoc · 24,064 bytesreferences/styled-text-editing.mddoc · 8,938 bytesreferences/text-patterns.mddoc · 1,637 bytesreferences/toolbar-patterns.mddoc · 10,159 bytesreferences/trace-analysis.mddoc · 16,948 bytesreferences/trace-recording.mddoc · 7,078 bytesreferences/view-structure.mddoc · 29,112 bytesreferences/webkit-integration.mddoc · 9,732 bytesscripts/analyze_trace.pyruns · 10,340 bytesscripts/instruments_parser/__init__.pyruns · 69 bytesscripts/instruments_parser/causes.pyruns · 6,092 bytesscripts/instruments_parser/correlate.pyruns · 6,367 bytesscripts/instruments_parser/events.pyruns · 10,804 bytesscripts/instruments_parser/hangs.pyruns · 3,507 bytesscripts/instruments_parser/hitches.pyruns · 4,634 bytesscripts/instruments_parser/summary.pyruns · 9,291 bytesscripts/instruments_parser/swiftui.pyruns · 6,798 bytesscripts/instruments_parser/time_profiler.pyruns · 4,385 bytesscripts/instruments_parser/xctrace.pyruns · 5,182 bytesscripts/instruments_parser/xml_utils.pyruns · 7,536 bytesscripts/record_trace.pyruns · 10,831 bytes
Read excerpt
# SwiftUI Expert Skill
## Operating Rules
- Treat each `View` type as an invalidation boundary: give it only the data it reads and keep frequently changing dependencies close to the smallest affected subtree
- Search `references/latest-apis.md` when writing, reviewing, or migrating API usage; look up only the APIs relevant to the task
- Replace hard-deprecated APIs with modern equivalents. During feature work, flag soft-deprecated APIs and leave them in place (see `references/soft-deprecation.md`)
- Prefer native SwiftUI APIs over UIKit/AppKit bridging unless bridging is necessary
- Focus on correctness and performance; do not enforce specific architectures (MVVM, VIPER, etc.)
- Encourage separating business logic from views for testability without mandating how
- Follow Apple's Human Interface Guidelines and API design patterns
- Only adopt Liquid Glass when explicitly requested by the user (see `references/liquid-glass.md`)
- Present performance optimizations as suggestions, not requirements
- Use `#available` gating with sensible fallbacks for version-specific APIs