mcpField
M
macos-development

macos-development

github.com/rshankrasDevelopment8381.6k installsUpdated 14w ago
Repository

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

  1. 01Swift 6+ language and concurrency guidance
  2. 02SwiftData schema, query, and performance advice
  3. 03Architecture and modular design patterns
  4. 04macOS 26 API and platform integration topics
  5. 05SwiftUI and AppKit interoperability guidance
  6. 06HIG, accessibility, and UI review guidance

Use cases

  1. 01Review Swift code in a macOS project
  2. 02Plan an app architecture or audit an existing app
  3. 03Investigate SwiftData performance and queries
  4. 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-development

After 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.md
new-app-planning.md
appkit-swiftui-bridge/
hosting-controllers.md
nsviewrepresentable.md
state-management.md
architecture-patterns/
design-patterns.md
modular-design.md
solid-detailed.md
coding-best-practices/
architecture-principles.md
code-organization.md
data-persistence.md
modern-concurrency.md
swift-language.md
macos-capabilities/
background.md
extensions.md
menubar.md
sandboxing.md
macos-tahoe-apis/
apple-intelligence.md
continuity.md
mlx-framework.md
tahoe-features.md
xcode16.md
swiftdata-architecture/
performance.md
query-patterns.md
repository-pattern.md
schema-design.md
ui-review-tahoe/
accessibility.md
appkit-modern.md
liquid-glass-design.md
macos-tahoe-hig.md

Details

From the project README

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

Comments

Markdown supported