charleswiltgen/axiom-watchos
axiom-codex/skills/axiom-watchos/SKILL.md
Use when building ANY watchOS app — app structure, independent apps, Watch Connectivity, Smart Stack widgets, complications, controls, RelevanceKit, background tasks, ClockKit migration.
$ install --global
skillsauthnpx skillsauth add charleswiltgen/axiom axiom-watchosInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 1, 2026, 10:05 AM124.8s1 file scanned
SKILL.md
- name:
- axiom-watchos
- description:
- Use when building ANY watchOS app — app structure, independent apps, Watch Connectivity, Smart Stack widgets, complications, controls, RelevanceKit, background tasks, ClockKit migration.
- license:
- MIT
watchOS Development
You MUST use this skill for ANY watchOS-specific development including app structure, independent apps, Watch Connectivity, complications and Smart Stack widgets, controls, Live Activities on watch, background tasks, and ClockKit migration.
Quick Reference
| Symptom / Task | Reference |
|----------------|-----------|
| App structure, independent apps, watchOS 26 submission requirements | See skills/platform-basics.md |
| watchOS HIG, glanceable UX, navigation model | See skills/design-for-watchos.md |
| Smart Stack widgets, complications, ClockKit→WidgetKit, RelevanceKit | See skills/smart-stack-and-complications.md |
| Controls on watch surfaces, Live Activities on watch | See skills/controls-and-live-activities.md |
| Watch Connectivity (WCSession), paired-device data transfer, Family Setup | See skills/watch-connectivity.md |
| Background tasks, freshness scheduling, TN3135 networking limits | See skills/background-and-networking.md |
| WatchKit→SwiftUI migration, ClockKit→WidgetKit migration | See skills/modernization.md |
Cross-Suite Routes
These topics overlap with watchOS development but live in separate suites:
SwiftUI (shared iOS/watchOS/macOS)
- View state, data flow, @Observable → See axiom-swiftui
- Navigation basics (NavigationStack) → See axiom-swiftui
- Layout, animations → See axiom-swiftui
Design
- General HIG, Liquid Glass, SF Symbols, typography → See axiom-design
Accessibility
- General VoiceOver, Dynamic Type, WCAG → See axiom-accessibility
- watchOS-specific (VoiceOver rotor on Digital Crown, AssistiveTouch, Double Tap) → See axiom-accessibility (
skills/watchos-a11y.md)
Health and workouts
- HealthKit,
HKWorkoutSession,HKLiveWorkoutBuilder, WorkoutKit → See axiom-health - Workout recovery, multi-device coordination → See axiom-health (
skills/workouts.md)
iOS-side widgets and App Intents
- iOS/iPadOS widgets, configuration intents, App Intents → See axiom-integration
- Live Activities on iPhone (initiation + ActivityKit) → See axiom-integration
Concurrency
- Swift 6 concurrency, actors, Sendable → See axiom-concurrency
Conflict Resolution
axiom-watchos vs axiom-swiftui: When building a watchOS SwiftUI app:
- Use axiom-watchos for watch-specific patterns: glanceable UI, constrained navigation, Digital Crown focus, Smart Stack placement
- Use axiom-swiftui for cross-platform SwiftUI: state management, layout primitives, animations
- Both may apply: A watchOS NavigationStack with complications needs axiom-watchos for complication surfaces and axiom-swiftui for NavigationStack basics
axiom-watchos vs axiom-integration: For widgets and Live Activities:
- Use axiom-watchos for watch complications, Smart Stack placement, watch-side Live Activity presentation, RelevanceKit
- Use axiom-integration for iOS/iPadOS widgets, core ActivityKit API, App Intents
axiom-watchos vs axiom-health: For workouts on Apple Watch:
- Use axiom-watchos for watch-specific presentation: Always On display, Smart Stack placement, background mode coordination
- Use axiom-health for
HKWorkoutSessionlifecycle,HKLiveWorkoutBuilder, recovery, multi-device mirroring
Decision Tree
digraph watchos {
start [label="watchOS development task" shape=ellipse];
what [label="What area?" shape=diamond];
start -> what;
what -> "skills/platform-basics.md" [label="app structure, independent apps, submission"];
what -> "skills/design-for-watchos.md" [label="watch HIG, glanceable UX"];
what -> "skills/smart-stack-and-complications.md" [label="complications, Smart Stack, RelevanceKit"];
what -> "skills/controls-and-live-activities.md" [label="controls, watch Live Activities"];
what -> "skills/watch-connectivity.md" [label="WCSession, paired-device transfer"];
what -> "skills/background-and-networking.md" [label="background tasks, networking limits"];
what -> "skills/modernization.md" [label="WatchKit/ClockKit migration"];
what -> "axiom-health" [label="workouts, HealthKit, WorkoutKit"];
what -> "axiom-swiftui" [label="general SwiftUI patterns"];
what -> "axiom-accessibility" [label="VoiceOver rotor, AssistiveTouch"];
what -> "axiom-integration" [label="iOS-side widgets, App Intents"];
}
Resources
WWDC: 2021-10003, 2022-10133, 2023-10138, 2023-10029, 2023-10309, 2024-10098, 2024-10157, 2024-10205, 2025-334
Docs: /watchos-apps/building-a-watchos-app, /watchos-apps/creating-independent-watchos-apps, /watchconnectivity, /widgetkit/creating-accessory-widgets-and-watch-complications, /widgetkit/converting-a-clockkit-app, /relevancekit, /technotes/tn3135-low-level-networking-on-watchos, /technotes/tn3157-updating-your-watchos-project-for-swiftui-and-widgetkit
Skills: axiom-swiftui, axiom-design, axiom-accessibility, axiom-health, axiom-integration, axiom-concurrency
Related Skills
charleswiltgen/axiom-health
development
VerifiedTrustedCommunity
Use when working with HealthKit, WorkoutKit, health data, workouts, or fitness features on iOS or watchOS. Covers permissions, queries, background delivery, custom workouts, multidevice coordination.
875SKILL.mdUpdated May 1, 2026
charleswiltgen/axiom-swiftui
development
VerifiedTrustedCommunity
Use when building, fixing, or improving ANY SwiftUI UI — views, navigation, layout, animations, performance, architecture, gestures, debugging, iOS 26 features.
875SKILL.mdUpdated Apr 20, 2026
charleswiltgen/axiom-media
content-media
VerifiedTrustedCommunity
Use when working with camera, photos, audio, haptics, ShazamKit, or Now Playing. Covers AVCaptureSession, PHPicker, PhotosPicker, AVFoundation, Core Haptics, audio recognition, MediaPlayer, CarPlay, MusicKit.
875SKILL.mdUpdated Apr 20, 2026
charleswiltgen/axiom-integration
tools
VerifiedTrustedCommunity
Use when integrating ANY iOS system feature - Siri, Shortcuts, widgets, IAP, localization, privacy, alarms, calendar, reminders, contacts, background tasks, push notifications, timers. Covers App Intents, WidgetKit, StoreKit, EventKit, Contacts.
875SKILL.mdUpdated Apr 20, 2026