mcpField
W
watchos

watchos

github.com/fusengineDevelopment3446 installsUpdated 1d ago
Repository

About watchos

watchos is a skill for developing Apple Watch experiences, aimed at developers building complications, fitness tracking, or iPhone sync. It covers HealthKit, Watch Connectivity, small-screen interactions, and battery-aware practices, and recommends validation on real hardware.

Key features

  1. 01Build watch-face complications
  2. 02Handle workouts and fitness tracking
  3. 03Access health metrics through HealthKit
  4. 04Sync with Watch Connectivity
  5. 05Design for small screens and battery use

Use cases

  1. 01Build an Apple Watch app
  2. 02Show glanceable watch-face data
  3. 03Record workouts and read health metrics
  4. 04Sync an iPhone with Apple Watch

Install

Copy the command and run it in a terminal.

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

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

Bundled files

References and scripts installed along with SKILL.md.

references/
complications.md
watch-connectivity.md
workouts.md

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, Force Touch on older watches, 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, large touch targets
  • Glanceable information
  • Minimal text, clear icons
Interactions
  • Digital Crown for scrolling/input
  • Force Touch (older watches)
  • Gestures: swipe, tap
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