mcpField
W
watchos

watchos

github.com/fusengineDevelopment3446 installsUpdated 2w ago
Repository

About watchos

A development skill for building Apple Watch apps, intended for developers working with watchOS features and interfaces. It covers complications, workouts, HealthKit, and iPhone–Watch connectivity alongside platform-specific interaction and battery guidance.

Key features

  1. 01Watch-face complications for glanceable data
  2. 02Workout sessions and fitness tracking
  3. 03HealthKit health-metric access
  4. 04iPhone–Watch communication
  5. 05Small-screen interaction and battery guidance

Use cases

  1. 01Building Apple Watch apps
  2. 02Showing data in watch-face complications
  3. 03Tracking workouts and fitness
  4. 04Syncing data between iPhone and Apple Watch

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/fusengine/claude-plugins --skill watchos

After installing, type/watchosin Claude Code to confirm it loaded.

Details

From the project README
Covers watchOS-specific development for Apple Watch: watch-face complications for glanceable data, workout sessions and fitness tracking, HealthKit access to health metrics, and Watch Connectivity for iPhone-Watch sync.

Includes design considerations specific to the platform — small display with large touch targets, glanceable information with minimal text, Digital Crown scrolling/input, swipe/tap gestures, and battery-conscious background work.

Best practices: keep information glanceable, use large tap targets, minimize text input, drive watch-face updates through complications, use efficient background refresh, and always validate on real hardware since the simulator behaves differently.

watchOS Platform

watchOS-specific development for Apple Watch experiences.

Agent Workflow (MANDATORY)

Before ANY implementation, spawn 3 agents in parallel, one Agent call each with a name:

  1. fuse-ai-pilot:explore-codebase - Analyze existing watchOS patterns
  2. fuse-ai-pilot:research-expert - Verify latest watchOS 27 docs via Context7/Exa
  3. mcp__apple-docs__search_apple_docs - Check watchOS patterns

After implementation, run fuse-ai-pilot:sniper for validation.

Overview

When to Use
  • Building Apple Watch apps
  • Creating watch face complications
  • Workout and fitness tracking
  • Health data access (HealthKit)
  • iPhone-Watch communication
Why watchOS Skill
FeatureBenefit
ComplicationsGlanceable data on watch face
WorkoutsFitness and health tracking
HealthKitAccess health metrics
ConnectivitySync with iPhone

Reference Guide

NeedReference
Watch face complicationscomplications.md
Workout sessions, HealthKitworkouts.md
iPhone ↔ Watch syncwatch-connectivity.md

Design Considerations

Screen Size
  • Small display; controls 44x44 pt default, 28x28 pt minimum
  • Text: 16 pt default, 12 pt minimum; support enlargement to at least 140%
  • Glanceable information, minimal text, clear icons

Source: https://developer.apple.com/design/human-interface-guidelines/accessibility

Interactions
  • Digital Crown for scrolling/input (HIG)
  • Gestures: swipe, tap
  • Complications and Smart Stack are WidgetKit accessory widgets (see swiftui-core/references/hig-system-surfaces.md)
Battery
  • Minimize background work
  • Use complications for updates
  • Efficient data transfer

Best Practices

  1. Glanceable - Quick information access
  2. Large targets - Easy tapping
  3. Minimal input - Reduce typing
  4. Complications - Update watch face data
  5. Background refresh - Efficient updates
  6. Test on device - Simulator differs from hardware

Comments

Markdown supported