create-watchos-version
/create-watchos-version
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.
- Author
- GhostScientist ↗
- Repository
- skills ↗
- Licence
- Apache-2.0
- Last repository change
- 03.09.2026
Assessment and security
- Files in this package
- 4
- Scripts
- 1
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 03.09.2026, without references to retired models or APIs.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
- 1 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: scripts/analyze_project.py
What it does and when to use it
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.
Original author description
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.
How it works
- Workflow
- Phase 1: Project Discovery
- Phase 2: Feature Mapping
- Phase 3: API Compatibility
- Phase 4: Architecture
- Phase 5: Plan Generation
- Phase 6: User Review
- Best Practices Reference
SKILL.md preview
---
name: create-watchos-version
description: 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.
license: Apache-2.0
metadata:
author: GhostScientist
version: "1.1"
---
# 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
Run the bundled analyzer first — it reports architecture, dependencies, existing targets, and
watchOS-incompatible frameworks as JSON:
```bash
python3 scripts/analyze_project.py <project_path>
```
Use its `watchos_incompatible` list to seed Phase 3. If the script fails or the project layout
is unusual, fall back to scanning manually 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 availability site:developer.apple.com`
### Quick Reference
**Available**: SwiftUI, SwiftData (10+), WidgetKit (9+), HealthKit, WorkoutKit, CoreLocation (limited), WatchConnectivity, CloudKit, CoreMotion, AVFoundation (audio), CoreBluetooth, Combine, Swift Concurrency
**Unavailable/Limited**: UIKit, WebKit, MapKit (limited), CoreImage (limited), ARKit, RealityKit, StoreKit (limited), Background URLSession (limited)
See `references/api-compatibility.md` for detailed compatibility matrix.
## Phase 4: Architecture
### Version Targeting
Each iOS release has a paired watchOS release. Derive the target from the project's existing
minimum iOS version rather than assuming the latest:
```
iOS 16+ → watchOS 9+ (WidgetKit complications)
iOS 17+ → watchOS 10+ (SwiftData, Smart Stack)
iOS 18+ → watchOS 11+ (Live Activities on Watch)
```
This mapping is a starting point, not an authority — newer OS versions ship every year. Confirm
the current pairing and any newer capabilities on developer.apple.com before committing to a
deployment target.
### Structure
```
Shared/
├── Models/ # Pure Swift, shared via target membership
├── Services/ # Platform-agnostic logic
└── Utilities/
WatchApp/
├── App.swift
├── Views/
├── ViewModels/
├── Complications/
└── WatchConnectivity/
```
### Design Principles
1. **Glanceability** - Visible within 2 seconds
2. **Minimal Interaction** - 1-3 taps max
3. **Context Awareness** - Time, location, activity
4. **Battery Conscious** - Efficient refresh, TimelineSchedule
5. **Haptic Feedback** - Confirm actions appropriately
### SwiftUI Gotchas
- Avoid nested TabViews (memory leaks)
- Use TimelineSchedule for efficient metric updates
- Check `isLuminanceReduced` to reduce work when dimmed
- Don't use data-driven high-frequency UI refreshes
## Phase 5: Plan Generation
Use template in `references/plan-template.md` to generate:
1. Executive Summary
2. ⚠️ API Compatibility Warnings table
3. Phased implementation tasks
4. Testing checklist
## Phase 6: User Review
Present plan and ask for approval before implementing:
> "I've analyzed your project and created a watchOS plan. Before proceeding:
> 1. **API Warnings**: [N] APIs unavailable—alternatives documented.
> 2. **Recommended Features**: [list] prioritized for Watch.
> 3. **Scope**: [N] phases.
>
> Proceed with implementation, or adjust the plan?"
**Do not implement until user approves.**
## Best Practices Reference
### Watch Connectivity
```swift
guard WCSession.default.activationState == .activated else { return }
// sendMessage: immediate, requires reachability
// transferUserInfo: queued, guaranteed
// transferCurrentComplicationUserInfo: complication priority
```
### Complications
```swift
// Use appropriate reload policy
Timeline(entries: entries, policy: .after(nextUpdateDate))
// Use .never for static complications
```
### Battery Efficiency
- Timeline-based over active refresh
- Check `isLuminanceReduced`
- Batch Watch Connectivity transfers
- Significant location change vs continuous updates
Files in this package (4)
- SKILL.md 6 KB
- references/api-compatibility.md 4 KB
- references/plan-template.md 8 KB
- scripts/analyze_project.py 10 KB
Versions
The database has no other skills named create-watchos-version.
Database snapshot: 13.11.2026 · package version 52dcda8501ce (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100apple-app-testing
Plan, execute and investigate iOS, iPadOS, tvOS, macOS, visionOS and watchOS app tests from macOS. Use for forms, inputs, screens, accessibility, lifecycle and compatibility using Xcode, simulators, physical hardware and researched cloud services, with explicit per-platform automation limits. - 90watchOS
watchOS development guidance including SwiftUI for Watch, Watch Connectivity, complications, and watch-specific UI patterns. Use for watchOS code review, best practices, or Watch app development. - 87swiftui-best-practice
SwiftUI のレイアウト落とし穴・ベストプラクティス・非推奨パターンと、 iOS / watchOS アプリの実機配布 (Provisioning / App Group / Code Signing / Apple Watch Developer Mode / Xcode 15+ Debug dylib) トラブルシューティング のガイド。コード生成・修正時に既知のレイアウトバグを防ぎ、 App Group + watchOS + Apple Watch の実機インストール失敗を 7 段階フレームワークで診断・解消する。 Use when:… - 100app-store-review
Evaluates code against Apple's App Store Review Guidelines. Use this skill when reviewing iOS, macOS, tvOS, watchOS, or visionOS app code (Swift, Objective-C, React Native, or Expo) to identify potential App Store rejection issues before submission. Triggers on tasks involving… - 100apple-ui-swiftui
Write native SwiftUI (with AppKit/UIKit fallbacks) that matches Apple's 26-series UI kits on iOS, iPadOS, macOS, visionOS and watchOS. Use when implementing a kit component or a Figma design as Swift code, adopting Liquid Glass APIs, or choosing the right system control instead… - 100apple
Develops Apple platform apps in Swift with SwiftUI and UIKit for iOS and macOS. Use when editing Swift or Xcode project files for iOS, macOS, watchOS or visionOS, when a build fails on Swift 6 concurrency or availability errors, when a view hangs or redraws too often, or when…