SwiftUI macOS
Runtime-level SwiftUI review for macOS: observation, concurrency, AppKit
Test report
- Verdict
- Tested · Works
- Score
- Tested
- Aug 10, 2026
- Environment
- Claude Code 2.x (agent harness)
Reviewed a 79-line macOS SwiftUI file with seeded observation traps twice — once cold, once with the references loaded — and the skill found five things the cold pass missed. The sharpest: because Doc is a struct inside an observed array, mutating one row's title fires _modify on the whole array and re-renders the entire List, which the cold review never suspected. It also replaced a weak fix with a better one, conforming the NSViewRepresentable to Equatable to stop updateNSView firing at all instead of guarding inside it. One inconsistency worth knowing: the concurrency reference tells you to prefer DispatchQueue.main.async over Task, but has no rule for the more common case of already being on MainActor and needing no hop at all. The README's install snippet works verbatim from a bare HOME, and every claim in its reference table matched the files on disk.
Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works
- Installs cleanly 5/5
- Triggers reliably 5/5
- Output vs. baseline 8/10
- Docs & honesty 5/5
What SwiftUI macOS does
Eight on-demand reference files that give Claude runtime-level knowledge of SwiftUI on macOS — how the observation registrar decides to notify, what _modify costs versus set, how view identity and NSViewRepresentable updates are gated. Triggers when you ask to build, review, or debug a macOS SwiftUI view, fix observation or re-render problems, bridge AppKit, or architect state ownership. Explicitly scoped away from iOS-only SwiftUI and basic Swift questions.
How to install SwiftUI macOS
git clone https://github.com/kageroumado/swiftui-macos-skill.git
mkdir -p ~/.claude/skills
cp -r swiftui-macos-skill/skills/swiftui-macos ~/.claude/skills/
Skills live in ~/.claude/skills/ (global) or .claude/skills/
(per-project). Restart Claude Code after installing.
Commands — how to trigger SwiftUI macOS
-
/swiftui-macosRuntime-level SwiftUI review for macOS: observation, concurrency, AppKit
It also activates on plain-language prompts like these:
-
Review this SwiftUI macOS file for observation and identity bugs -
Check this NSViewRepresentable code for update-gating issues -
Debug why this macOS SwiftUI sidebar view re-renders too often
Frequently asked questions
- Is the SwiftUI macOS skill free?
- Yes. The skill itself is free from kageroumado/swiftui-macos-skill. SkillProof publishes the install command and an independent test verdict at no cost.
- Does SwiftUI macOS work with Claude Code?
- We tested it with Claude Code 2.x (agent harness) on Aug 10, 2026. Verdict: Tested · Works. Reviewed a 79-line macOS SwiftUI file with seeded observation traps twice — once cold, once with the references loaded — and the skill found five things the cold pass missed. The sharpest: because Doc is a struct inside an observed array, mutating one row's title fires _modify on the whole array and re-renders the entire List, which the cold review never suspected. It also replaced a weak fix with a better one, conforming the NSViewRepresentable to Equatable to stop updateNSView firing at all instead of guarding inside it. One inconsistency worth knowing: the concurrency reference tells you to prefer DispatchQueue.main.async over Task, but has no rule for the more common case of already being on MainActor and needing no hop at all. The README's install snippet works verbatim from a bare HOME, and every claim in its reference table matched the files on disk.
- What is the SwiftUI macOS SkillProof Score?
- 9.2/10 — installs cleanly 5/5, triggers reliably 5/5, output vs. baseline 8/10, docs & honesty 5/5.
- How do I install SwiftUI macOS?
- Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
- Can I use SwiftUI macOS with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
- The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.