swiftui-guidance-for-macos — Claude Code plugin: how to install
Runtime-level SwiftUI guidance for macOS applications in Claude Code. Helps debug state tracking, actor scheduling, and AppKit integration issues.
/plugin marketplace add anthropics/claude-plugins-community
/plugin install swiftui-guidance-for-macos@claude-communityWhat swiftui-guidance-for-macos does
The plugin equips Claude Code with technical references on SwiftUI internals for macOS. It details the mechanics of observation tracking, including _modify accessors, version counters, and Observations {} streams, helping identify why views drop their state or trigger redundant updates.
Reference documents cover AppKit integration with NSViewRepresentable and NSHostingView, macOS scenes such as MenuBarExtra, and SwiftData persistence via @ModelActor. They also outline accessibility setup for VoiceOver and keyboard navigation.
Because the guidance targets macOS 26+ and Swift 6.2 with strict concurrency, it omits beginner syntax to focus on actor isolation boundaries and modern Swift evolution proposals.
What it helps with
- debug redundant view rendering and identity graph resets
- bridge AppKit components using
NSViewRepresentableandNSHostingView - handle actor isolation and background persistence with SwiftData
- configure macOS scenes, menu bar items, and keyboard navigation
Example prompts for the agent
- /swiftui-macos diagnose why view state resets inside this NSViewRepresentable
- /swiftui-macos configure debounced background saving with SwiftData and @ModelActor
- /swiftui-macos inspect this SwiftUI view hierarchy for redundant body evaluations
How to install swiftui-guidance-for-macos
Plugin marketplace
/plugin marketplace add anthropics/claude-plugins-community/plugin install swiftui-guidance-for-macos@claude-communityStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about swiftui-guidance-for-macos
How to install swiftui-guidance-for-macos in Claude Code?
First add the community marketplace by running /plugin marketplace add anthropics/claude-plugins-community. Then install the plugin using /plugin install swiftui-guidance-for-macos@claude-community.
Which versions of macOS and Swift does this plugin target?
It specifically targets macOS 26+ and Swift 6.2 with strict concurrency enabled.
What topics do the reference guides cover?
They cover observation mechanics, actor isolation rules, AppKit bridging, window scene configuration, and VoiceOver accessibility.
Source text
SKILL.md · MIT
# SwiftUI macOS Skill
An agent skill for macOS SwiftUI work, centered on observation internals, actor scheduling, view identity and AppKit integration. Its reference files explain framework behavior behind common failures, including redundant updates, lost view state and incorrect actor hops.
```text
/plugin marketplace add kageroumado/swiftui-macos-skill
/plugin install swiftui-macos
```
## Highlights
- Trace common SwiftUI failures to observation, scheduling, and view-identity behavior.
- Use the same skill for writing and reviewing macOS code.
- Consult focused references for AppKit integration, persistence, performance, and accessibility.
<details>
<summary>Full feature list</summary>
| File | Coverage |
|---|---|
| `references/observation.md` | Observation tracking: state capture, `_modify` vs `set`, version counters, scope narrowing, `Observations {}` streams, computed property propagation |
| `references/concurrency.md` | Scheduling cost hierarchy, actor isolation, SE-0461/0469/0420/0471/0472, `AsyncStream` bridging, `@concurrent`, `sending` |
| `references/views.md` | View decomposition, `.task(id:)`, preference keys, custom `Layout`, animation, navigation |
| `references/data.md` | Manager pattern, `@Bindable`, SwiftData, debounced saving, `@ModelActor`, environment injection |
| `references/platform.md` | `NSViewRepresentable`, `NSHostingView`, multi-window state, `openWindow`, AppKit bridging, macOS scenes |
| `references/scenes.md` | Scene and window API catalog: `UtilityWindow`, `MenuBarExtra` styles, `Settings`, window sizing and chrome, `Commands`, file dialogs, `Table`, `PasteButton` |
| `references/performance.md` | View identity graph, `.id()` dangers, `Equatable` views, `@State` for gestures, `Canvas`, `TimelineView`, `drawingGroup()` |
| `references/api.md` | Deprecated API replacements, Swift modernisms, `@Previewable`, `@Entry`, Apple open-source Swift packages |
| `references/accessibility.md` | VoiceOver, Dynamic Type, keyboard navigation, accessibility rotors, `@AccessibilityFocusState`, drag-and-drop a11y, testing |
</details>
## Notes
- Invoke `/swiftui-macos` in Claude Code or `$swiftui-macos` in Codex.
- Manual installation: copy `skills/swiftui-macos` into the agent’s user or project skills directory.
- Contributions should explain recurring errors or framework behavior and include supporting evidence.
© kageroumado · MIT · kageroumado/swiftui-macos-skill
