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/.

watchOS Platform

watchOS-specific development for Apple Watch experiences.

Agent Workflow (MANDATORY)

Before ANY implementation, use TeamCreate to spawn 3 agents:

  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