Skip to main content
skill CX Codex

watchos-code-review — Claude Code skill: review and install

The watchos-code-review skill reviews watchOS code for lifecycle, complications, WatchConnectivity, and resource limits. Use it when checking WatchKit or SwiftUI app code.

Apache-2.0 137 installs ★ 89 updated 2026-09-15

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add existential-birds/beagle --skill watchos-code-review -a claude-code
Open on GitHub

What watchos-code-review does

The skill reviews watchOS code that uses WatchKit, WKExtension, WKApplicationDelegate, or WCSession. It checks app lifecycle and background behavior, extended runtime sessions, ClockKit and WidgetKit complications, iPhone–Watch communication, memory, battery use, and performance constraints.

Its checklist is backed by reference sections for lifecycle, complications, connectivity, and performance. Every reported issue must include [FILE:LINE], cover the surrounding implementation, and include a concrete watchOS or device-pairing artifact when the claim depends on platform behavior. A finding without that evidence should remain a review question.

The checks include delegate assignment before WCSession.activate(), reachability before sendMessage, transferUserInfo for critical data, background downloads through URLSessionDownloadTask, future timeline entries, and workout-session recovery. Reports use the format [FILE:LINE] ISSUE_TITLE.

What it helps with

  • review watchOS app lifecycle handling
  • spot missing or invalid WidgetKit timeline entries
  • check WCSession message and file-transfer logic
  • find background-task, memory, and battery issues
  • enforce file-and-line evidence for review findings

Example prompts for the agent

  • Review this watchOS code and report every issue as [FILE:LINE] ISSUE_TITLE.
  • Check whether WCSession, background tasks, and file transfers are handled correctly between iPhone and Apple Watch.
  • Review this WidgetKit complication for future timeline entries and Smart Stack relevance.

How to install watchos-code-review

1Skills CLI (Vercel)

npx skills add existential-birds/beagle --skill watchos-code-review -a claude-code

2Manually: put the files in place

~/.claude/skills/watchos-code-review/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/watchos-code-review/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about watchos-code-review

How do I install watchos-code-review in Claude Code?

Run npx skills add existential-birds/beagle --skill watchos-code-review -a claude-code, then check ~/.claude/skills/watchos-code-review/SKILL.md.

What does watchos-code-review do?

It reviews watchOS code for lifecycle and background behavior, ClockKit and WidgetKit complications, WatchConnectivity, memory, battery, and performance constraints. Findings include a file and line location.

What does the skill check in WCSession code?

It checks delegate setup before activate(), reachability before sendMessage, transferUserInfo for critical data, and synchronous file handling before a delegate callback returns.

Source text

SKILL.md · Apache-2.0
---
name: watchos-code-review
description: Reviews watchOS code for app lifecycle, complications (ClockKit/WidgetKit), WatchConnectivity, and performance constraints. Use when reviewing code with import WatchKit, WKExtension, WKApplicationDelegate, WCSession, or watchOS-specific patterns.
---

# watchOS Code Review

## Quick Reference

| Issue Type | Reference |
|------------|-----------|
| App lifecycle, scenes, background modes, extended runtime | [references/lifecycle.md](references/lifecycle.md) |
| ClockKit, WidgetKit, timeline providers, Smart Stack | [references/complications.md](references/complications.md) |
| WCSession, message passing, file transfer, reachability | [references/connectivity.md](references/connectivity.md) |
| Memory limits, background refresh, battery optimization | [references/performance.md](references/performance.md) |

## Review Checklist

- [ ] SwiftUI App protocol used with `@WKApplicationDelegateAdaptor` for lifecycle events
- [ ] `scenePhase` read from root view (not sheets/modals where it's always `.active`)
- [ ] `WKExtendedRuntimeSession` started only while app is active (not from background)
- [ ] Workout sessions recovered in `applicationDidFinishLaunching` (not just delegate)
- [ ] Background tasks scheduled at least 5 minutes apart; next scheduled before completing current
- [ ] `URLSessionDownloadTask` (not `DataTask`) used for background network requests
- [ ] WidgetKit used instead of ClockKit for watchOS 9+ complications
- [ ] Timeline includes future entries (not just current state); gaps avoided
- [ ] `TimelineEntryRelevance` implemented for Smart Stack prioritization
- [ ] WCSession delegate set before `activate()`; singleton pattern used
- [ ] `isReachable` checked before `sendMessage`; `transferUserInfo` for critical data
- [ ] Received files moved synchronously before delegate callback returns

## When to Load References

- Reviewing app lifecycle, background modes, or extended sessions -> lifecycle.md
- Reviewing complications, widgets, or timeline providers -> complications.md
- Reviewing WCSession, iPhone-Watch communication -> connectivity.md
- Reviewing memory, battery, or performance issues -> performance.md

## Output Format

Report issues using: `[FILE:LINE] ISSUE_TITLE`

Examples:

- `[WatchApp.swift:18] WKExtendedRuntimeSession started while app not active`
- `[ConnectivityManager.swift:42] WCSession.activate() before delegate assignment`
- `[ComplicationTimeline.swift:67] Timeline has no future entries`

## Hard gates (before reporting)

Complete **in order** for each finding you intend to report. Do not advance until the pass condition is satisfied.

1. **Location artifact** — The finding includes `[FILE:LINE]` (or a line range) copied from the current file contents; the path resolves in this repo.
2. **Scope read** — You read the full surrounding unit: the `View` body, `WKApplicationDelegate` / scene method, `TimelineProvider` implementation, `WCSessionDelegate` callback, or workout/background task handler that owns the behavior—not only a diff hunk.
3. **watchOS or pairing claim** (only if the finding depends on background modes, complication/timeline contracts, `WCSession` reachability or transfer semantics, workout or extended runtime rules, or device-specific limits) — You name one concrete artifact you inspected (for example `Info.plist` / target capabilities for background modes, the `WK*` / `WCSession` call order in source, entitlements, or a subsection you read in the matching doc from [Quick Reference](#quick-reference)) **or** you downgrade the item to an open question in [Review Questions](#review-questions).
4. **Protocol** — Pre-report steps in [review-verification-protocol](../review-verification-protocol/SKILL.md) are satisfied for this item (no finding if they are not).

Use the issue format `[FILE:LINE] ISSUE_TITLE` for each reported finding. Hard gate 4 is the full pre-report checklist for this skill’s review type.

## Review Questions

1. Is the app using modern SwiftUI lifecycle with delegate adaptor?
2. Are background tasks completing properly (calling `setTaskCompletedWithSnapshot`)?
3. Is UI update frequency reduced when `isLuminanceReduced` is true?
4. Are WatchConnectivity delegate callbacks dispatching to main thread?
5. Is `TabView` nested within another `TabView`? (Memory leak on watchOS)

© existential-birds · Apache-2.0 · existential-birds/beagle

Similar skills

All skills for Mobile →

From the same set68

The whole set →
adr-decision-extraction The adr-decision-extraction skill pulls architectural decisions from chats and session transcripts before ADR writing. It identifies technology choices, trade-offs, and explicit decision tags. CX Codex +1 144installs deepagents-implementation deepagents-implementation is a Claude Code skill with recipes for building agents on Deep Agents: create_deep_agent, file backends, subagents and LangGraph streaming. CX Codex +1 142installs llm-judge llm-judge ranks two or more implementations of the same task against a spec file: facts first, then scores across five dimensions, then a report naming the winner. CX Codex +1 141installs pydantic-ai-dependency-injection pydantic-ai-dependency-injection — a skill for wiring databases, API clients, and user context into PydanticAI agents with RunContext and deps_type. CX Codex +1 141installs swiftdata-code-review swiftdata-code-review reviews SwiftData code for model relationships, query predicates, actor concurrency, and schema migrations. Works on .swift files. CX Codex +1 136installs howto-docs The howto-docs skill shapes task-focused how-to guides with prerequisites, actionable steps, result checks, and troubleshooting for readers who already know the product. CX Codex +1 135installs deepagents-code-review deepagents-code-review reviews Deep Agents code and flags what breaks agents at runtime: interrupt_on with no checkpointer, backends with no store. CX Codex +1 134installs healthkit-code-review healthkit-code-review walks HealthKit code through a fixed sequence: authorization, queries, observers, background delivery. Handy when you are the one reviewing health data work. CX Codex +1 134installs

Project sponsors

Companies that keep this analytics open