[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75BMMFJZKKG6F65WRPF0WSJ":3,"skill-same:01M75BMMFJZKKG6F65WRPF0WSJ":44},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":14,"categories":15,"keywords":16,"publishedAt":17,"linkOnly":18,"markdownContent":19,"markdownBody":20,"frontMatter":21,"refName":22,"commitSha":23,"skillDirectory":24,"forksCount":25,"repositoryHtmlUrl":26,"repositoryHomepageUrl":27,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":29,"install":30,"resources":43},"01M75BMMFJZKKG6F65WRPF0WSJ","swiftui-expert-skill",null,"ruake\u002FAWARE","ruake","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F253885939?v=4","01M75AVBM7FRFTS61RZRNMZB6C","01M75AVBMYHD7500NHVANF1HKM",0,"MIT","https:\u002F\u002Fgithub.com\u002Fruake\u002FAWARE\u002Fblob\u002Fmain\u002F.opencode\u002Fskills\u002Fswiftui-expert-skill\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: swiftui-expert-skill\ndescription: - Consult `references\u002Flatest-apis.md` at the start of every task to avoid deprecated APIs\n---\n\n# SwiftUI Expert Skill\n\n## Operating Rules\n\n- Consult `references\u002Flatest-apis.md` at the start of every task to avoid deprecated APIs\n- Prefer native SwiftUI APIs over UIKit\u002FAppKit bridging unless bridging is necessary\n- Focus on correctness and performance; do not enforce specific architectures (MVVM, VIPER, etc.)\n- Encourage separating business logic from views for testability without mandating how\n- Follow Apple's Human Interface Guidelines and API design patterns\n- Only adopt Liquid Glass when explicitly requested by the user (see `references\u002Fliquid-glass.md`)\n- Present performance optimizations as suggestions, not requirements\n- Use `#available` gating with sensible fallbacks for version-specific APIs\n\n## Task Workflow\n\n### Review existing SwiftUI code\n- Read the code under review and identify which topics apply\n- Flag deprecated APIs (compare against `references\u002Flatest-apis.md`)\n- Run the Topic Router below for each relevant topic\n- Validate `#available` gating and fallback paths for iOS 26+ features\n\n### Improve existing SwiftUI code\n- Audit current implementation against the Topic Router topics\n- Replace deprecated APIs with modern equivalents from `references\u002Flatest-apis.md`\n- Refactor hot paths to reduce unnecessary state updates\n- Extract complex view bodies into separate subviews\n- Suggest image downsampling when `UIImage(data:)` is encountered (optional optimization, see `references\u002Fimage-optimization.md`)\n\n### Implement new SwiftUI feature\n- Design data flow first: identify owned vs injected state\n- Structure views for optimal diffing (extract subviews early)\n- Apply correct animation patterns (implicit vs explicit, transitions)\n- Use `Button` for all tappable elements; add accessibility grouping and labels\n- Gate version-specific APIs with `#available` and provide fallbacks\n\n### Record a new Instruments trace\nTrigger when the user asks to \"record a trace\", \"profile the app\", \"capture a session\", etc. Full reference: `references\u002Ftrace-recording.md`.\n\n1. **Confirm target** — attach to a running app, launch an app, or record all processes? If the user didn't say, ask. List connected devices when useful:\n   ```bash\n   python3 \"${SKILL_DIR}\u002Fscripts\u002Frecord_trace.py\" --list-devices\n   ```\n2. **Pick a template based on target kind** — the `SwiftUI` template populates the SwiftUI lane on any **real device**: a physical iOS\u002FiPadOS device **or the host Mac**. The only exception is the **iOS Simulator**, where the SwiftUI lane comes back empty — switch to `--template \"Time Profiler\"` in that case (still gives Time Profiler + Hangs + Animation Hitches). Always check `--list-devices`: `simulators` kind → `Time Profiler`; `devices` kind (real devices and the host Mac) → default `SwiftUI`. Full decision table in `references\u002Ftrace-recording.md`.\n3. **Start the recording**. For agent-driven sessions where the user says \"I'll tell you when I'm done\", start in the background and use a stop-file:\n   ```bash\n   python3 \"${SKILL_DIR}\u002Fscripts\u002Frecord_trace.py\" \\\n       --device \"\u003Cname|udid>\" --attach \"\u003CAppName>\" \\\n       --stop-file \u002Ftmp\u002Fstop-trace --output ~\u002FDesktop\u002Fsession.trace\n   ```\n   For interactive sessions, just tell the user to press Ctrl+C when done.\n4. **Signal stop** — when the user says they've finished exercising the app, `touch \u002Ftmp\u002Fstop-trace`. The script cleanly SIGINTs xctrace and waits up to 60s for finalisation.\n5. **Analyse** the resulting trace (flow into the \"Trace-driven improvement\" workflow below).\n\n### Trace-driven improvement (Instruments `.trace` provided)\nTrigger whenever the user's request references a `.trace` file. A target SwiftUI source file is **optional** — if given, cite specific lines; if not, recommend where to look based on view names and symbols the trace already reveals.\n\nFull reference: `references\u002Ftrace-analysis.md`. Summary of the composition pattern:\n\n1. **Scope the analysis.** Ask yourself: does the user want the whole trace, or a slice?\n   - \"focus on X \u002F after X \u002F between X and Y \u002F during X\" → **resolve to a window first** (see step 2).\n   - No scoping cue → analyse the whole trace.\n2. **Resolve a window (only if the user scoped).** The parser exposes two discovery modes:\n   ```bash\n   # Find a log that marks the start\u002Fend of the region of interest:\n   python3 \"${SKILL_DIR}\u002Fscripts\u002Fanalyze_trace.py\" --trace \u003Cpath> \\\n       --list-logs --log-message-contains \"loaded feed\" --log-limit 5\n   # Or list os_signpost intervals (paired begin\u002Fend), filterable by name:\n   python3 \"${SKILL_DIR}\u002Fscripts\u002Fanalyze_trace.py\" --trace \u003Cpath> \\\n       --list-signposts --signpost-name-contains \"ImageDecode\"\n   ```\n   Both modes accept `--window START_MS:END_MS` to scope discovery. Pick the `time_ms` (for logs) or `start_ms`\u002F`end_ms` (for signposts) that match the user's description. Build a window like `--window 10400:11700`.\n3. **Run the main analysis** (with or without `--window`):\n   ```bash\n   python3 \"${SKILL_DIR}\u002Fscripts\u002Fanalyze_trace.py\" --trace \u003Cpath> \\\n       --json-only --top 10 [--window START_MS:END_MS]\n   ```\n4. **Interpret with `references\u002Ftrace-analysis.md`** — key diagnostics:\n   - `main_running_coverage_pct` inside each correlation (\u003C25% = blocked; ≥75% = CPU-bound).\n   - `swiftui-causes.top_sources` reveals *why* updates keep happening — high-edge-count sources like `UserDefaultObserver.send()` or wide `EnvironmentWriter` entries are structural invalidation bugs. Fixing one often collapses many downstream hot views.\n5. **When a specific view shows as expensive, ask who's invalidating it.** Use `--fanin-for \"\u003Cview name>\"` to get the ranked list of source nodes driving the updates.\n6. **Optionally ground in source.** If the user pointed at a file, read it and match view names \u002F user-code symbols against identifiers there. If not, recommend which files to open based on the view names SwiftUI reported.\n7. **Return a prioritised plan.** Cite evidence (coverage %, hot symbol, overlapping view, log timestamp, cause-graph edges) and route each recommendation to a Topic Router reference.\n8. Only edit code if the user asked for edits.\n\n### Topic Router\n\nConsult the reference file for each topic relevant to the current task:\n\n| Topic | Reference |\n|-------|-----------|\n| State management | `references\u002Fstate-management.md` |\n| View composition | `references\u002Fview-structure.md` |\n| Performance | `references\u002Fperformance-patterns.md` |\n| Lists and ForEach | `references\u002Flist-patterns.md` |\n| Layout | `references\u002Flayout-best-practices.md` |\n| Sheets and navigation | `references\u002Fsheet-navigation-patterns.md` |\n| ScrollView | `references\u002Fscroll-patterns.md` |\n| Focus management | `references\u002Ffocus-patterns.md` |\n| Animations (basics) | `references\u002Fanimation-basics.md` |\n| Animations (transitions) | `references\u002Fanimation-transitions.md` |\n| Animations (advanced) | `references\u002Fanimation-advanced.md` |\n| Accessibility | `references\u002Faccessibility-patterns.md` |\n| Swift Charts | `references\u002Fcharts.md` |\n| Charts accessibility | `references\u002Fcharts-accessibility.md` |\n| Image optimization | `references\u002Fimage-optimization.md` |\n| Liquid Glass (iOS 26+) | `references\u002Fliquid-glass.md` |\n| macOS scenes | `references\u002Fmacos-scenes.md` |\n| macOS window styling | `references\u002Fmacos-window-styling.md` |\n| macOS views | `references\u002Fmacos-views.md` |\n| Text patterns | `references\u002Ftext-patterns.md` |\n| Localization | `references\u002Flocalization.md` |\n| Deprecated API lookup | `references\u002Flatest-apis.md` |\n| Handling soft-deprecated APIs | `references\u002Fsoft-deprecation.md` |\n| Previews | `references\u002Fpreviews.md` |\n| Instruments trace analysis | `references\u002Ftrace-analysis.md` |\n| Instruments trace recording | `references\u002Ftrace-recording.md` |\n\n## Correctness Checklist\n\nThese are hard rules -- violations are always bugs:\n\n- [ ] `@State` properties are `private`\n- [ ] `@Binding` only where a child modifies parent state\n- [ ] Passed values never declared as `@State` or `@StateObject` (they ignore updates)\n- [ ] `@StateObject` for view-owned objects; `@ObservedObject` for injected\n- [ ] iOS 17+: `@State` with `@Observable`; `@Bindable` for injected observables needing bindings\n- [ ] `ForEach` uses stable identity (never `.indices`\u002F`\\.offset`; id outlives the view and isn't derived from mutable content)\n- [ ] Constant number of views per `ForEach` element; `List` rows are unary\n- [ ] No closures stored in custom `@Environment`\u002F`@FocusedValue` keys\n- [ ] Custom `@Entry` default values are stable (no `Model()`\u002F`Date()`\u002F`UUID()` expressions)\n- [ ] `.animation(_:value:)` always includes the `value` parameter\n- [ ] `@FocusState` properties are `private`\n- [ ] No redundant `@FocusState` writes inside tap gesture handlers on `.focusable()` views\n- [ ] iOS 26+ APIs gated with `#available` and fallback provided\n- [ ] `import Charts` present in files using chart types\n- [ ] Previews use self-contained mock data; no dependency on live services or network\n\n## References\n\n- `references\u002Flatest-apis.md` -- **Read first for every task.** Deprecated-to-modern API transitions (iOS 15+ through iOS 26+)\n- `references\u002Fstate-management.md` -- Property wrappers, data flow, `@Observable` migration\n- `references\u002Fview-structure.md` -- View extraction, container patterns, `@ViewBuilder`\n- `references\u002Fperformance-patterns.md` -- Hot-path optimization, update control, `_logChanges()`\n- `references\u002Flist-patterns.md` -- ForEach identity, Table (iOS 16+), inline filtering pitfalls\n- `references\u002Flayout-best-practices.md` -- Layout patterns, GeometryReader alternatives\n- `references\u002Faccessibility-patterns.md` -- VoiceOver, Dynamic Type, grouping, traits\n- `references\u002Fanimation-basics.md` -- Implicit\u002Fexplicit animations, timing, performance\n- `references\u002Fanimation-transitions.md` -- View transitions, `matchedGeometryEffect`, `Animatable`\n- `references\u002Fanimation-advanced.md` -- Phase\u002Fkeyframe animations (iOS 17+), `@Animatable` macro (iOS 26+)\n- `references\u002Fcharts.md` -- Swift Charts marks, axes, selection, styling, Chart3D (iOS 26+)\n- `references\u002Fcharts-accessibility.md` -- Charts VoiceOver, Audio Graph, fallback strategies\n- `references\u002Fsheet-navigation-patterns.md` -- Sheets, NavigationSplitView, Inspector\n- `references\u002Fscroll-patterns.md` -- ScrollViewReader, programmatic scrolling\n- `references\u002Ffocus-patterns.md` -- Focus state, focusable views, focused values, default focus, common pitfalls\n- `references\u002Fimage-optimization.md` -- AsyncImage, downsampling, caching\n- `references\u002Fliquid-glass.md` -- iOS 26+ Liquid Glass effects and fallback patterns\n- `references\u002Fmacos-scenes.md` -- Settings, MenuBarExtra, WindowGroup, multi-window\n- `references\u002Fmacos-window-styling.md` -- Toolbar styles, window sizing, Commands\n- `references\u002Fmacos-views.md` -- HSplitView, Table, PasteButton, AppKit interop\n- `references\u002Fpreviews.md` -- `#Preview` macro, `@Previewable` (iOS 18+), preview traits, mock data patterns for self-contained previews\n- `references\u002Ftext-patterns.md` -- Text initializer selection, verbatim vs localized\n- `references\u002Flocalization.md` -- String Catalogs, `#bundle` for packages, `LocalizedStringResource`, locale-aware formatting, RTL layout, translator comments\n- `references\u002Fsoft-deprecation.md` -- How to behave with soft-deprecated APIs (when to migrate, scoping rule, don't migrate during unrelated edits)\n- `references\u002Ftrace-analysis.md` -- Parse Instruments `.trace` files via `scripts\u002Fanalyze_trace.py`; interpret main-thread coverage, high-severity SwiftUI updates, hitch narratives, and map findings back to source files\n- `references\u002Ftrace-recording.md` -- Record a new trace via `scripts\u002Frecord_trace.py`: attach to a running app, launch one fresh, or capture a manually-stopped session; supports stop-file for agent-driven flows\n","# SwiftUI Expert Skill\n\n## Operating Rules\n\n- Consult `references\u002Flatest-apis.md` at the start of every task to avoid deprecated APIs\n- Prefer native SwiftUI APIs over UIKit\u002FAppKit bridging unless bridging is necessary\n- Focus on correctness and performance; do not enforce specific architectures (MVVM, VIPER, etc.)\n- Encourage separating business logic from views for testability without mandating how\n- Follow Apple's Human Interface Guidelines and API design patterns\n- Only adopt Liquid Glass when explicitly requested by the user (see `references\u002Fliquid-glass.md`)\n- Present performance optimizations as suggestions, not requirements\n- Use `#available` gating with sensible fallbacks for version-specific APIs\n\n## Task Workflow\n\n### Review existing SwiftUI code\n- Read the code under review and identify which topics apply\n- Flag deprecated APIs (compare against `references\u002Flatest-apis.md`)\n- Run the Topic Router below for each relevant topic\n- Validate `#available` gating and fallback paths for iOS 26+ features\n\n### Improve existing SwiftUI code\n- Audit current implementation against the Topic Router topics\n- Replace deprecated APIs with modern equivalents from `references\u002Flatest-apis.md`\n- Refactor hot paths to reduce unnecessary state updates\n- Extract complex view bodies into separate subviews\n- Suggest image downsampling when `UIImage(data:)` is encountered (optional optimization, see `references\u002Fimage-optimization.md`)\n\n### Implement new SwiftUI feature\n- Design data flow first: identify owned vs injected state\n- Structure views for optimal diffing (extract subviews early)\n- Apply correct animation patterns (implicit vs explicit, transitions)\n- Use `Button` for all tappable elements; add accessibility grouping and labels\n- Gate version-specific APIs with `#available` and provide fallbacks\n\n### Record a new Instruments trace\nTrigger when the user asks to \"record a trace\", \"profile the app\", \"capture a session\", etc. Full reference: `references\u002Ftrace-recording.md`.\n\n1. **Confirm target** — attach to a running app, launch an app, or record all processes? If the user didn't say, ask. List connected devices when useful:\n   ```bash\n   python3 \"${SKILL_DIR}\u002Fscripts\u002Frecord_trace.py\" --list-devices\n   ```\n2. **Pick a template based on target kind** — the `SwiftUI` template populates the SwiftUI lane on any **real device**: a physical iOS\u002FiPadOS device **or the host Mac**. The only exception is the **iOS Simulator**, where the SwiftUI lane comes back empty — switch to `--template \"Time Profiler\"` in that case (still gives Time Profiler + Hangs + Animation Hitches). Always check `--list-devices`: `simulators` kind → `Time Profiler`; `devices` kind (real devices and the host Mac) → default `SwiftUI`. Full decision table in `references\u002Ftrace-recording.md`.\n3. **Start the recording**. For agent-driven sessions where the user says \"I'll tell you when I'm done\", start in the background and use a stop-file:\n   ```bash\n   python3 \"${SKILL_DIR}\u002Fscripts\u002Frecord_trace.py\" \\\n       --device \"\u003Cname|udid>\" --attach \"\u003CAppName>\" \\\n       --stop-file \u002Ftmp\u002Fstop-trace --output ~\u002FDesktop\u002Fsession.trace\n   ```\n   For interactive sessions, just tell the user to press Ctrl+C when done.\n4. **Signal stop** — when the user says they've finished exercising the app, `touch \u002Ftmp\u002Fstop-trace`. The script cleanly SIGINTs xctrace and waits up to 60s for finalisation.\n5. **Analyse** the resulting trace (flow into the \"Trace-driven improvement\" workflow below).\n\n### Trace-driven improvement (Instruments `.trace` provided)\nTrigger whenever the user's request references a `.trace` file. A target SwiftUI source file is **optional** — if given, cite specific lines; if not, recommend where to look based on view names and symbols the trace already reveals.\n\nFull reference: `references\u002Ftrace-analysis.md`. Summary of the composition pattern:\n\n1. **Scope the analysis.** Ask yourself: does the user want the whole trace, or a slice?\n   - \"focus on X \u002F after X \u002F between X and Y \u002F during X\" → **resolve to a window first** (see step 2).\n   - No scoping cue → analyse the whole trace.\n2. **Resolve a window (only if the user scoped).** The parser exposes two discovery modes:\n   ```bash\n   # Find a log that marks the start\u002Fend of the region of interest:\n   python3 \"${SKILL_DIR}\u002Fscripts\u002Fanalyze_trace.py\" --trace \u003Cpath> \\\n       --list-logs --log-message-contains \"loaded feed\" --log-limit 5\n   # Or list os_signpost intervals (paired begin\u002Fend), filterable by name:\n   python3 \"${SKILL_DIR}\u002Fscripts\u002Fanalyze_trace.py\" --trace \u003Cpath> \\\n       --list-signposts --signpost-name-contains \"ImageDecode\"\n   ```\n   Both modes accept `--window START_MS:END_MS` to scope discovery. Pick the `time_ms` (for logs) or `start_ms`\u002F`end_ms` (for signposts) that match the user's description. Build a window like `--window 10400:11700`.\n3. **Run the main analysis** (with or without `--window`):\n   ```bash\n   python3 \"${SKILL_DIR}\u002Fscripts\u002Fanalyze_trace.py\" --trace \u003Cpath> \\\n       --json-only --top 10 [--window START_MS:END_MS]\n   ```\n4. **Interpret with `references\u002Ftrace-analysis.md`** — key diagnostics:\n   - `main_running_coverage_pct` inside each correlation (\u003C25% = blocked; ≥75% = CPU-bound).\n   - `swiftui-causes.top_sources` reveals *why* updates keep happening — high-edge-count sources like `UserDefaultObserver.send()` or wide `EnvironmentWriter` entries are structural invalidation bugs. Fixing one often collapses many downstream hot views.\n5. **When a specific view shows as expensive, ask who's invalidating it.** Use `--fanin-for \"\u003Cview name>\"` to get the ranked list of source nodes driving the updates.\n6. **Optionally ground in source.** If the user pointed at a file, read it and match view names \u002F user-code symbols against identifiers there. If not, recommend which files to open based on the view names SwiftUI reported.\n7. **Return a prioritised plan.** Cite evidence (coverage %, hot symbol, overlapping view, log timestamp, cause-graph edges) and route each recommendation to a Topic Router reference.\n8. Only edit code if the user asked for edits.\n\n### Topic Router\n\nConsult the reference file for each topic relevant to the current task:\n\n| Topic | Reference |\n|-------|-----------|\n| State management | `references\u002Fstate-management.md` |\n| View composition | `references\u002Fview-structure.md` |\n| Performance | `references\u002Fperformance-patterns.md` |\n| Lists and ForEach | `references\u002Flist-patterns.md` |\n| Layout | `references\u002Flayout-best-practices.md` |\n| Sheets and navigation | `references\u002Fsheet-navigation-patterns.md` |\n| ScrollView | `references\u002Fscroll-patterns.md` |\n| Focus management | `references\u002Ffocus-patterns.md` |\n| Animations (basics) | `references\u002Fanimation-basics.md` |\n| Animations (transitions) | `references\u002Fanimation-transitions.md` |\n| Animations (advanced) | `references\u002Fanimation-advanced.md` |\n| Accessibility | `references\u002Faccessibility-patterns.md` |\n| Swift Charts | `references\u002Fcharts.md` |\n| Charts accessibility | `references\u002Fcharts-accessibility.md` |\n| Image optimization | `references\u002Fimage-optimization.md` |\n| Liquid Glass (iOS 26+) | `references\u002Fliquid-glass.md` |\n| macOS scenes | `references\u002Fmacos-scenes.md` |\n| macOS window styling | `references\u002Fmacos-window-styling.md` |\n| macOS views | `references\u002Fmacos-views.md` |\n| Text patterns | `references\u002Ftext-patterns.md` |\n| Localization | `references\u002Flocalization.md` |\n| Deprecated API lookup | `references\u002Flatest-apis.md` |\n| Handling soft-deprecated APIs | `references\u002Fsoft-deprecation.md` |\n| Previews | `references\u002Fpreviews.md` |\n| Instruments trace analysis | `references\u002Ftrace-analysis.md` |\n| Instruments trace recording | `references\u002Ftrace-recording.md` |\n\n## Correctness Checklist\n\nThese are hard rules -- violations are always bugs:\n\n- [ ] `@State` properties are `private`\n- [ ] `@Binding` only where a child modifies parent state\n- [ ] Passed values never declared as `@State` or `@StateObject` (they ignore updates)\n- [ ] `@StateObject` for view-owned objects; `@ObservedObject` for injected\n- [ ] iOS 17+: `@State` with `@Observable`; `@Bindable` for injected observables needing bindings\n- [ ] `ForEach` uses stable identity (never `.indices`\u002F`\\.offset`; id outlives the view and isn't derived from mutable content)\n- [ ] Constant number of views per `ForEach` element; `List` rows are unary\n- [ ] No closures stored in custom `@Environment`\u002F`@FocusedValue` keys\n- [ ] Custom `@Entry` default values are stable (no `Model()`\u002F`Date()`\u002F`UUID()` expressions)\n- [ ] `.animation(_:value:)` always includes the `value` parameter\n- [ ] `@FocusState` properties are `private`\n- [ ] No redundant `@FocusState` writes inside tap gesture handlers on `.focusable()` views\n- [ ] iOS 26+ APIs gated with `#available` and fallback provided\n- [ ] `import Charts` present in files using chart types\n- [ ] Previews use self-contained mock data; no dependency on live services or network\n\n## References\n\n- `references\u002Flatest-apis.md` -- **Read first for every task.** Deprecated-to-modern API transitions (iOS 15+ through iOS 26+)\n- `references\u002Fstate-management.md` -- Property wrappers, data flow, `@Observable` migration\n- `references\u002Fview-structure.md` -- View extraction, container patterns, `@ViewBuilder`\n- `references\u002Fperformance-patterns.md` -- Hot-path optimization, update control, `_logChanges()`\n- `references\u002Flist-patterns.md` -- ForEach identity, Table (iOS 16+), inline filtering pitfalls\n- `references\u002Flayout-best-practices.md` -- Layout patterns, GeometryReader alternatives\n- `references\u002Faccessibility-patterns.md` -- VoiceOver, Dynamic Type, grouping, traits\n- `references\u002Fanimation-basics.md` -- Implicit\u002Fexplicit animations, timing, performance\n- `references\u002Fanimation-transitions.md` -- View transitions, `matchedGeometryEffect`, `Animatable`\n- `references\u002Fanimation-advanced.md` -- Phase\u002Fkeyframe animations (iOS 17+), `@Animatable` macro (iOS 26+)\n- `references\u002Fcharts.md` -- Swift Charts marks, axes, selection, styling, Chart3D (iOS 26+)\n- `references\u002Fcharts-accessibility.md` -- Charts VoiceOver, Audio Graph, fallback strategies\n- `references\u002Fsheet-navigation-patterns.md` -- Sheets, NavigationSplitView, Inspector\n- `references\u002Fscroll-patterns.md` -- ScrollViewReader, programmatic scrolling\n- `references\u002Ffocus-patterns.md` -- Focus state, focusable views, focused values, default focus, common pitfalls\n- `references\u002Fimage-optimization.md` -- AsyncImage, downsampling, caching\n- `references\u002Fliquid-glass.md` -- iOS 26+ Liquid Glass effects and fallback patterns\n- `references\u002Fmacos-scenes.md` -- Settings, MenuBarExtra, WindowGroup, multi-window\n- `references\u002Fmacos-window-styling.md` -- Toolbar styles, window sizing, Commands\n- `references\u002Fmacos-views.md` -- HSplitView, Table, PasteButton, AppKit interop\n- `references\u002Fpreviews.md` -- `#Preview` macro, `@Previewable` (iOS 18+), preview traits, mock data patterns for self-contained previews\n- `references\u002Ftext-patterns.md` -- Text initializer selection, verbatim vs localized\n- `references\u002Flocalization.md` -- String Catalogs, `#bundle` for packages, `LocalizedStringResource`, locale-aware formatting, RTL layout, translator comments\n- `references\u002Fsoft-deprecation.md` -- How to behave with soft-deprecated APIs (when to migrate, scoping rule, don't migrate during unrelated edits)\n- `references\u002Ftrace-analysis.md` -- Parse Instruments `.trace` files via `scripts\u002Fanalyze_trace.py`; interpret main-thread coverage, high-severity SwiftUI updates, hitch narratives, and map findings back to source files\n- `references\u002Ftrace-recording.md` -- Record a new trace via `scripts\u002Frecord_trace.py`: attach to a running app, launch one fresh, or capture a manually-stopped session; supports stop-file for agent-driven flows\n",{},"main","6184979e01f673905139589c194eab38198db2f7",".opencode\u002Fskills\u002Fswiftui-expert-skill",1,"https:\u002F\u002Fgithub.com\u002Fruake\u002FAWARE","https:\u002F\u002Fruake.github.io\u002FAWARE","https:\u002F\u002Fgithub.com\u002Fruake","2026-11-15 04:27:27",{"source":7,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add ruake\u002FAWARE --skill swiftui-expert-skill",{"tool":36,"command":37},"bunx","bunx skills add ruake\u002FAWARE --skill swiftui-expert-skill",{"tool":39,"command":40},"pnpm","pnpm dlx skills add ruake\u002FAWARE --skill swiftui-expert-skill","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fruake\u002FAWARE\u002Fblob\u002Fmain\u002F.opencode\u002Fskills\u002Fswiftui-expert-skill\u002FSKILL.md",true,[],[45,51,58,65,72,78],{"skillNo":46,"name":47,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":48,"categories":49,"keywords":50,"publishedAt":17},"01M75BPBYT89TEE87CGBDX2KF5","xlsx","https:\u002F\u002Fgithub.com\u002Fruake\u002FAWARE\u002Fblob\u002Fmain\u002F.opencode\u002Fskills\u002Fxlsx\u002FSKILL.md",[],[],{"skillNo":52,"name":53,"nameZh":6,"description":54,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":17},"01M75BPA000S9MTH5MY7CZNYYQ","writing-plans","Write comprehensive implementation plans assuming the engineer has zero context for our codebase and questionable taste.","https:\u002F\u002Fgithub.com\u002Fruake\u002FAWARE\u002Fblob\u002Fmain\u002F.opencode\u002Fskills\u002Fwriting-plans\u002FSKILL.md",[],[],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":17},"01M75BP80ETH9GYVRH8A7QPCSG","web-design-guidelines","Review files for compliance with Web Interface Guidelines.","https:\u002F\u002Fgithub.com\u002Fruake\u002FAWARE\u002Fblob\u002Fmain\u002F.opencode\u002Fskills\u002Fweb-design-guidelines\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":17},"01M75BP5XG8SX5Q2WWZB6QRVFT","web-component-design","Build reusable, maintainable UI components using modern frameworks with clean composition patterns and styling approache","https:\u002F\u002Fgithub.com\u002Fruake\u002FAWARE\u002Fblob\u002Fmain\u002F.opencode\u002Fskills\u002Fweb-component-design\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":17},"01M75BP4B1FC4V81QR1VB56H1E","web-artifacts-builder","https:\u002F\u002Fgithub.com\u002Fruake\u002FAWARE\u002Fblob\u002Fmain\u002F.opencode\u002Fskills\u002Fweb-artifacts-builder\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":17},"01M75BP1XVRW8WQ2XXAJBAYV2V","vueuse-functions","This skill is a decision-and-implementation guide for VueUse composables in Vue.js \u002F Nuxt projects. It maps requirements","https:\u002F\u002Fgithub.com\u002Fruake\u002FAWARE\u002Fblob\u002Fmain\u002F.opencode\u002Fskills\u002Fvueuse-functions\u002FSKILL.md",[],[]]