Skip to main content
Generalfusengine

watchos

watchOS platform-specific development with complications, workouts, HealthKit, and Watch Connectivity. Use when building Apple Watch apps, health features, or iPhone-Watch communication.

Stars
13
Source
fusengine/agents
Updated
2026-05-17
Slug
fusengine--agents--watchos
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/fusengine/agents/HEAD/plugins/swift-apple-expert/skills/watchos/SKILL.md -o .claude/skills/watchos.md

Drops the SKILL.md into .claude/skills/watchos.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

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 26 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

Feature Benefit
Complications Glanceable data on watch face
Workouts Fitness and health tracking
HealthKit Access health metrics
Connectivity Sync with iPhone

Reference Guide

Need Reference
Watch face complications complications.md
Workout sessions, HealthKit workouts.md
iPhone ↔ Watch sync watch-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