macos-development — Claude Code skill for macOS apps
A skill for building macOS apps: Swift 6+, SwiftUI, SwiftData, AppKit bridging and macOS 26 Tahoe APIs. Useful for code review and architecture questions.
npx skills add rshankras/claude-code-apple-skills --skill macos-development -a claude-code
npx skills add rshankras/claude-code-apple-skills --skill macos -a claude-codeWhat macos-development does
The skill activates when you ask about macOS development practices, want a review of Swift code, or check a UI against HIG. It ships as a set of modules the agent reads on demand: coding-best-practices/ covers Swift 6+ and concurrency, architecture-patterns/ handles SOLID and modular design, swiftdata-architecture/ deals with schemas, queries and performance.
Platform topics live in their own folders. macos-tahoe-apis/ covers macOS 26 features, Apple Intelligence, MLX and Xcode 16. macos-capabilities/ is about sandboxing and entitlements, while appkit-swiftui-bridge/ explains wrapping AppKit views for SwiftUI. There is also ui-review-tahoe/ for Liquid Glass and accessibility checks, plus app-planner/ for planning a new app or auditing an existing one.
The skill is limited to Read, Glob, Grep and WebFetch, so it never edits your files. Ask it to rewrite code and you get advice instead of a patch. It runs in Claude, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode.
What it helps with
- review Swift 6+ code and drop outdated idioms
- design a SwiftData schema with model relationships
- speed up SwiftData queries with better predicates
- wrap an AppKit view in SwiftUI via NSViewRepresentable
- check a UI against HIG and accessibility rules
Example prompts for the agent
- review my project for Swift 6 and tell me what to rewrite
- how should I model a SwiftData schema for notes with tags
- review this screen for Liquid Glass and accessibility
How to install macos-development
1Skills CLI (Vercel)
npx skills add rshankras/claude-code-apple-skills --skill macos-development -a claude-codenpx skills add rshankras/claude-code-apple-skills --skill macos -a claude-code2Manually: put the files in place
~/.claude/skills/macos/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/macos/
1Skills CLI (Vercel)
npx skills add rshankras/claude-code-apple-skills --skill macos -a codex2Manually: put the files in place
.agents/skills/macos/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add rshankras/claude-code-apple-skills --skill macos -a cursor2Manually: put the files in place
.cursor/skills/macos/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install rshankras/claude-code-apple-skills macos2Manually: put the files in place
.github/skills/macos/SKILL.md1Skills CLI (Vercel)
npx skills add rshankras/claude-code-apple-skills --skill macos -a gemini-cli2Platform CLI
gemini skills install https://github.com/rshankras/claude-code-apple-skills --path skills/macosManually: put the files in place
.devin/skills/macos/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add rshankras/claude-code-apple-skills --skill macos -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about macos-development
How do I install macos-development in Claude?
Run npx skills add rshankras/claude-code-apple-skills --skill macos-development -a claude-code. The skill file then lands at ~/.claude/skills/macos/SKILL.md.
What does macos-development do?
It gives the agent a reference on macOS development: Swift 6+, SwiftUI, SwiftData, architecture patterns, AppKit-SwiftUI bridging and macOS 26 Tahoe APIs. The agent reads the module that fits your question.
Which tools can the skill use?
Only Read, Glob, Grep and WebFetch. It does not change code, so you get analysis and recommendations and apply the edits yourself.
Source text
SKILL.md · MIT
--- name: macos-development description: Comprehensive macOS development guidance including Swift 6+, SwiftUI, SwiftData, architecture patterns, AppKit bridging, and macOS 26 Tahoe APIs. Use for macOS code review, best practices, UI review, or platform-specific features. allowed-tools: [Read, Glob, Grep, WebFetch] last_verified: 2026-07-16 review_by: 2027-06-22 os_version: iOS 27 / macOS 27 --- # macOS Development Expert Comprehensive guidance for macOS app development. This skill aggregates specialized modules for different aspects of macOS development. ## When This Skill Activates Use this skill when the user: - Asks about macOS development best practices - Wants code review for macOS/Swift projects - Needs help with SwiftUI, SwiftData, or AppKit - Is implementing macOS 26 (Tahoe) features - Wants UI/UX review against HIG - Needs architecture guidance for macOS apps ## Available Modules Read relevant module files based on the user's needs: ### coding-best-practices/ Swift 6+ code quality and modern idioms. - `swift-language.md` - Modern Swift patterns - `modern-concurrency.md` - async/await, actors, Sendable - `data-persistence.md` - SwiftData, UserDefaults, Keychain - `code-organization.md` - Project structure and modularity - `architecture-principles.md` - Clean architecture patterns ### architecture-patterns/ Software design and architecture. - `solid-detailed.md` - SOLID principles with Swift examples - `design-patterns.md` - Common design patterns - `modular-design.md` - Modular architecture approaches ### swiftdata-architecture/ SwiftData deep dive. - `schema-design.md` - Model design and relationships - `query-patterns.md` - Efficient queries and predicates - `performance.md` - Optimization techniques ### macos-tahoe-apis/ macOS 26 specific features. - `tahoe-features.md` - New macOS 26 capabilities - `apple-intelligence.md` - AI/ML integration - `mlx-framework.md` - On-device ML with MLX - `continuity.md` - Cross-device features - `xcode16.md` - Xcode 16 tools and features ### macos-capabilities/ Platform integration. - `sandboxing.md` - App Sandbox and entitlements - System integration features ### appkit-swiftui-bridge/ Hybrid development. - `nsviewrepresentable.md` - Wrapping AppKit views - State management between frameworks ### ui-review-tahoe/ UI/UX review for macOS 26. - Liquid Glass design system - HIG compliance checking - Accessibility review ### app-planner/ Project planning and analysis. - New app architecture planning - Existing app audits ## How to Use 1. Identify user's need from their question 2. Read relevant module files from subdirectories 3. Apply the guidance to their specific context 4. Reference Apple documentation when needed ## Example Workflow **User asks about SwiftData performance:** 1. Read `swiftdata-architecture/performance.md` 2. Read `swiftdata-architecture/query-patterns.md` if relevant 3. Apply recommendations to their code
© rshankras · MIT · rshankras/claude-code-apple-skills
