Analyzes existing iOS/macOS/Apple platform projects to create a comprehensive, phased plan for building a watchOS companion or standalone app. Use when users want to add watchOS support to an existing Apple platform app, create a Watch app version of their iOS app, or build watchOS features. The skill digests project architecture, identifies patterns, analyzes API compatibility, searches for current watchOS documentation, and produces a detailed implementation plan with API availability warnings before any code generation.
View on GitHubskills/create-watchos-version/SKILL.md
February 1, 2026
Select agents to install to:
npx add-skill https://github.com/GhostScientist/skills/blob/main/skills/create-watchos-version/SKILL.md -a claude-code --skill create-watchos-versionInstallation paths:
.claude/skills/create-watchos-version/# Create watchOS Version Analyzes existing Apple platform projects and creates detailed, phased implementation plans for watchOS apps that are elegant, top-tier experiences—not naive skins of the parent app. ## Workflow 1. **Project Discovery** - Analyze project structure, patterns, architecture 2. **Feature Mapping** - Identify watchOS-suitable features and priorities 3. **API Compatibility** - Search web for current watchOS API availability 4. **Architecture Planning** - Design watchOS-specific architecture 5. **Plan Generation** - Create phased plan with warnings and alternatives 6. **User Review** - Present plan for approval before implementation ## Phase 1: Project Discovery Scan project root for: ``` ├── App Architecture (SwiftUI, UIKit, AppKit, hybrid) ├── Data Layer (Core Data, SwiftData, Realm, custom) ├── Networking (URLSession, Alamofire, custom) ├── State Management (ObservableObject, TCA, Redux-like) ├── Navigation (NavigationStack, Coordinator) ├── Shared Frameworks (SPM packages, shared targets) ├── Assets (colors, images, SF Symbols) ├── Existing Watch Target (if any) └── Minimum iOS Version (affects watchOS targeting) ``` Key files: `*.xcodeproj`, `Package.swift`, `Info.plist`, App entry points, ViewModels, Models. ## Phase 2: Feature Mapping **Glanceable (High Priority)**: Status displays, counters, progress, recent items, quick stats **Quick Actions (High Priority)**: Single-tap toggles, shortcuts, haptic confirmations **Complications/Widgets (Critical)**: Map data to WidgetKit families—accessoryCircular, accessoryRectangular, accessoryInline, accessoryCorner. Consider Smart Stack relevance. **Background**: HealthKit integration, background refresh, Watch Connectivity sync **Defer/Exclude**: Complex data entry, long-form content, sustained screen time features ## Phase 3: API Compatibility **CRITICAL**: Always search web for current watchOS docs before finalizing. APIs change frequently. Search: `[FrameworkName] watchOS availabilit