Przejdź do treści
Biblioteka skilli
Programowanie · Planowanie

create-watchos-version

/create-watchos-version

Analizuje istniejące projekty iOS i macOS i tworzy etapowy plan budowy aplikacji towarzyszącej lub samodzielnej na watchOS, z oceną architektury i zgodności API.

Repozytorium
skills ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
03.09.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
4
Skrypty
1
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 03.09.2026, bez odwołań do wycofanych modeli i API.

Licencja

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

Co sprawdzić przed instalacją
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/analyze_project.py

Co robi i kiedy

Analizuje istniejące projekty iOS i macOS i tworzy etapowy plan budowy aplikacji towarzyszącej lub samodzielnej na watchOS, z oceną architektury i zgodności API.

Oryginalny opis (EN)

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.

Jak działa

  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
Sekcje z nagłówków SKILL.md, w oryginale · 161 linii, 678 słów
Podgląd SKILL.md
---
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
Pliki w paczce (4)
  • SKILL.md 6 KB
  • references/api-compatibility.md 4 KB
  • references/plan-template.md 8 KB
  • scripts/analyze_project.py 10 KB

Wersje

W bazie nie ma innych skilli o nazwie create-watchos-version.

Migawka bazy z 13.11.2026 · wersja paczki 52dcda8501ce (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100apple-app-testing
    Planuje i wykonuje testy aplikacji iOS, iPadOS, macOS, watchOS i innych z poziomu macOS, w symulatorach i na sprzęcie.
  • 90watchOS
    Daje wskazówki do tworzenia aplikacji watchOS: SwiftUI dla Watch, Watch Connectivity, komplikacje i wzorce interfejsu zegarka, także przy przeglądzie kodu.
  • 87swiftui-best-practice
    Podpowiada, jak unikać błędów układu SwiftUI oraz diagnozuje problemy z podpisywaniem i instalacją aplikacji iOS i watchOS.
  • 100app-store-review
    Ocenia kod aplikacji na iOS, macOS, tvOS, watchOS i visionOS (Swift, Objective-C, React Native, Expo) względem wytycznych Apple App Store Review, wskazując potencjalne powody odrzucenia przed zgłoszeniem.
  • 100apple-ui-swiftui
    Pisze natywny kod SwiftUI z rezerwą w AppKit i UIKit, zgodny z zestawami Apple 26 dla iOS, macOS, visionOS i watchOS.
  • 100apple
    Pisze aplikacje Apple w Swift z SwiftUI i UIKit dla iOS i macOS, pomaga przy błędach kompilacji i wydajności widoków.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.