Skip to content
Skills Library
Programming · Planning

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.

Repository
skills ↗
Licence
Apache-2.0
Last repository change
03.09.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
4
Scripts
1
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 03.09.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What to check before installing
  • 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

  1. Workflow
  2. Phase 1: Project Discovery
  3. Phase 2: Feature Mapping
  4. Phase 3: API Compatibility
  5. Phase 4: Architecture
  6. Phase 5: Plan Generation
  7. Phase 6: User Review
  8. Best Practices Reference
Original SKILL.md headings · 161 lines, 678 words
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…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.