About macos-development
macos-development is a skill for developers building or reviewing macOS apps with Swift. It organizes guidance into modules covering coding practices, architecture, SwiftData, platform capabilities, and UI review.
Key features
- 01Swift 6+ language and concurrency guidance
- 02SwiftData schema, query, and performance advice
- 03Architecture and modular design patterns
- 04macOS 26 API and platform integration topics
- 05SwiftUI and AppKit interoperability guidance
- 06HIG, accessibility, and UI review guidance
Use cases
- 01Review Swift code in a macOS project
- 02Plan an app architecture or audit an existing app
- 03Investigate SwiftData performance and queries
- 04Assess a macOS interface against HIG and accessibility
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ rshankras/ claude-code-apple-skills --skill macos-developmentAfter installing, type/macos-developmentin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
app-planner/existing-app-analysis.mdnew-app-planning.mdappkit-swiftui-bridge/hosting-controllers.mdnsviewrepresentable.mdstate-management.mdarchitecture-patterns/design-patterns.mdmodular-design.mdsolid-detailed.mdcoding-best-practices/architecture-principles.mdcode-organization.mddata-persistence.mdmodern-concurrency.mdswift-language.mdmacos-capabilities/background.mdextensions.mdmenubar.mdsandboxing.mdmacos-tahoe-apis/apple-intelligence.mdcontinuity.mdmlx-framework.mdtahoe-features.mdxcode16.mdswiftdata-architecture/performance.mdquery-patterns.mdrepository-pattern.mdschema-design.mdui-review-tahoe/accessibility.mdappkit-modern.mdliquid-glass-design.mdmacos-tahoe-hig.mdDetails
From the project READMEmacOS 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 patternsmodern-concurrency.md- async/await, actors, Sendabledata-persistence.md- SwiftData, UserDefaults, Keychaincode-organization.md- Project structure and modularityarchitecture-principles.md- Clean architecture patterns
architecture-patterns/
Software design and architecture.
solid-detailed.md- SOLID principles with Swift examplesdesign-patterns.md- Common design patternsmodular-design.md- Modular architecture approaches
swiftdata-architecture/
SwiftData deep dive.
schema-design.md- Model design and relationshipsquery-patterns.md- Efficient queries and predicatesperformance.md- Optimization techniques
macos-tahoe-apis/
macOS 26 specific features.
tahoe-features.md- New macOS 26 capabilitiesapple-intelligence.md- AI/ML integrationmlx-framework.md- On-device ML with MLXcontinuity.md- Cross-device featuresxcode16.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
- Identify user's need from their question
- Read relevant module files from subdirectories
- Apply the guidance to their specific context
- Reference Apple documentation when needed
Example Workflow
User asks about SwiftData performance:
- Read
swiftdata-architecture/performance.md - Read
swiftdata-architecture/query-patterns.mdif relevant - Apply recommendations to their code