rshankras/claude-code-apple-skills
Overview
This skill generates a complete technical architecture specification for iOS and macOS apps from a Product Requirements Document (PRD). It produces an ARCHITECTURE.md covering architecture pattern, technology stack, data models, and app structure tailored to Apple platform best practices. Use it to accelerate design decisions and produce a shareable architecture artifact for the team.
How this skill works
The skill reads the PRD and any available product plan, extracts core features, non-functional requirements, data model hints, and platform constraints, then selects an opinionated architecture and tech stack (SwiftUI, SwiftData, URLSession, etc.). It outputs a structured ARCHITECTURE.md including high-level diagrams, key decisions, module breakdown, data models, navigation and state management, and persistence strategy. The spec is adjustable by asking for preferences like SwiftUI vs UIKit or third-party library allowances.
When to use it
- When creating ARCHITECTURE.md from a reviewed PRD
- During initial system design for an iOS/macOS MVP
- Before starting implementation to align team on tech choices
- When evaluating trade-offs between frameworks and patterns
- When preparing handoff documentation for engineers
Best practices
- Target iOS 17+/macOS equivalent to leverage @Observable and SwiftData where possible
- Favor SwiftUI and MVVM for most apps; choose TCA or Clean for complex state needs
- Keep third-party dependencies minimal; prefer SPM and Apple frameworks for MVP
- Organize code by feature (Views, ViewModels, Models) with shared Core/Services modules
- Model data with SwiftData @Model, use Keychain for secrets and FileManager for large files
Example use cases
- Generate a draft ARCHITECTURE.md for an iOS app from docs/PRD.md
- Decide between SwiftData and Core Data for persistence given feature needs
- Define navigation and deep-linking strategy using NavigationStack and NavigationPath
- Produce module layout and file examples for onboarding, home, and detail features
- Create data flow and ViewModel examples using @Observable and async/await
FAQ
A reviewed PRD located at docs/PRD.md is required; include product plan or specify preferences if available.
Can I request UIKit or a different pattern instead of MVVM/SwiftUI?
Yes. Provide your preference (UIKit, TCA, VIPER) and the spec will adapt rationale, modules, and tooling accordingly.
Will this include third-party library recommendations?
By default the spec starts with zero third-party dependencies and only recommends packages when they provide clear value; list preferences if you want specific libraries considered.
49 skills
This skill generates a comprehensive ARCHITECTURE.md for an iOS/macOS app based on the PRD, outlining pattern, stack, data models, and structure.
This skill converts PRD and implementation details into a complete test specification and QA plan for iOS/macOS apps, including unit, integration, and UI
This skill helps you master SwiftData architecture by applying best practices for schema design, queries, repositories, and performance optimization.
This skill generates a detailed Swift iOS implementation guide with pseudo-code and step-by-step development steps from PRD, architecture, and UX specs.
This skill guides macOS 26 Tahoe development, highlighting Apple Intelligence, MLX, and Continuity integrations with modern Xcode 16 practices.
This skill replaces print statements with a structured Swift Logger setup, improving privacy, performance, and debugging across modules.
This skill helps you configure and implement App Store review prompts with customizable timing, platform checks, and StoreKit integration.
This skill provides expert guidance on macOS capabilities like sandboxing, extensions, menu bar apps, and background execution to implement system integrations.
This skill helps you validate app ideas, analyze markets, and scope MVPs to guide product decisions and maximize launch success.
This skill helps plan and audit iOS/Swift apps from concept to architecture, delivering a comprehensive plan and actionable recommendations.
This skill generates a comprehensive App Store release specification documenting submission steps, assets, privacy compliance, and launch strategy.
This skill provides expert guidance for bridging AppKit and SwiftUI, including NSViewRepresentable, hosting controllers, and cross-framework state management.
This skill generates a complete feature flag infrastructure with local defaults, remote config, SwiftUI integration, and a debug menu for iOS/macOS apps.
This skill generates a production-ready persistence layer in SwiftData or CoreData with optional iCloud sync for local and cloud data storage.
This skill reviews SwiftUI code for HIG compliance, typography, and accessibility, ensuring Dynamic Type support and platform-specific guidelines.
This skill generates production-ready Swift WidgetKit widgets with configurable sizes, types, and lock screen support to accelerate app enhancement.
This skill provides a senior release review for macOS and iOS apps, identifying security, privacy, UX, and distribution issues with actionable fixes.
This skill helps optimize App Store assets and captions by planning screenshot sequences and messaging to boost ASO and user engagement.
This skill performs comprehensive macOS Tahoe UI/UX reviews, ensuring Liquid Glass, HIG compliance, SwiftUI patterns, accessibility, and AppKit modernization
This skill generates UI/UX specifications and wireframes from PRD and architecture, delivering UX_SPEC.md and DESIGN_SYSTEM.md for iOS/macOS apps.
This skill enables camera-based visual search integration with iOS Visual Intelligence to surface app content quickly.
This skill conducts deep market research for iOS/macOS apps, delivering TAM/SAM/SOM, growth, barriers, channels, and revenue potential to guide decisions.
This skill helps you implement Liquid Glass UI in SwiftUI using the glassEffect API for modern, interactive, and morphing designs.
This skill builds a production image loading pipeline with memory and disk caching, deduplication, and a drop-in CachedAsyncImage view for SwiftUI.
This skill generates a production-ready HTTP caching layer in Swift, enabling offline support, Cache-Control parsing, and ETag-based requests to reduce API
This skill generates a cross-module integration test scaffold with mock servers, in-memory stores, and test configuration to validate full-stack flows.
This skill generates Swift test data factories and builders to reduce boilerplate and speed up test setup with reusable fixtures.
This skill helps you set up SwiftUI snapshot tests with swift-snapshot-testing, generating boilerplate and CI configuration for reliable UI regression checks.
This skill guides you through red-green-refactor for new features, generating tests first and ensuring code passes via AI-driven implementation.
This skill defines protocol contract tests in Swift to ensure every implementation passes identical behavioral tests.
This skill helps you adopt Swift 6.2 concurrency features like default MainActor inference and @concurrent to reduce data-race errors.
This skill helps you implement Siri, Shortcuts, and Spotlight integration using App Intents, enabling interactive snippets, indexing, and voice-driven actions.
This skill helps diagnose and fix SwiftUI performance issues by pinpointing unnecessary re-renders, identity problems, and slow body evaluations.
This skill helps you design SwiftData model hierarchies with class inheritance, enabling polymorphic queries and proper schema migrations.
This skill helps you implement AlarmKit alarms and timers in iOS 18+ apps with custom UI, Live Activities, and snooze support.
This skill helps you implement and customize SwiftUI toolbars with search, transitions, and platform-specific behavior for polished apps.
This skill enables embedding and controlling web content in SwiftUI apps using WebView and WebPage for navigation, JS interop, and customization.
This skill provides comprehensive migration guides for moving between Apple framework generations, outlining before/after mappings, coexistence strategies, and
This skill helps you design and adapt visionOS widgets for mounting styles, textures, proximity levels, and spatial families to enhance immersive experiences.
This skill helps you work with PlaceDescriptor patterns for geocoding, MapKit integration, and multi-service location data.
This skill helps you review and fix Swift concurrency issues, migrate to Swift 6, and apply structured concurrency patterns to prevent data races.
This skill helps you implement, review, and fix SwiftUI animation patterns, improving transitions, PhaseAnimator and KeyframeAnimator workflows, and symbol
This skill generates tailored iOS/macOS app ideas by profiles, ranks 3-5 options, and outputs ready-to-run validation prompts.
This skill helps you review and migrate Swift concurrency code to 6.2, prevent data races, and apply structured concurrency patterns.
This skill generates production-grade macOS and iOS app icons programmatically in Swift, producing all required sizes for asset catalogs.
This skill generates a production-ready SwiftUI settings screen with modular sections and platform-appropriate integration for iOS and macOS.
This skill converts a product development plan into a complete PRD.md with features, user stories, acceptance criteria, and success metrics.
This skill generates a protocol-based analytics setup with swappable providers to track events without changing app code.
This skill guides watchOS development with SwiftUI, connectivity, and complications to optimize app design, performance, and user experience.
