Agent skill

watchos-code-review

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.

View SKILL.md on GitHub Repository
Stars 44
Forks 5

Install this agent skill to your Project

npx add-skill https://github.com/existential-birds/beagle/tree/main/plugins/beagle-ios/skills/watchos-code-review

SKILL.md

watchOS Code Review

Quick Reference

Issue Type Reference
App lifecycle, scenes, background modes, extended runtime references/lifecycle.md
ClockKit, WidgetKit, timeline providers, Smart Stack references/complications.md
WCSession, message passing, file transfer, reachability references/connectivity.md
Memory limits, background refresh, battery optimization 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

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)

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

existential-birds/beagle

review-python

Comprehensive Python/FastAPI backend code review with optional parallel agents

44 5
Explore
existential-birds/beagle

review-verification-protocol

Mandatory verification steps for all code reviews to reduce false positives. Load this skill before reporting ANY code review findings.

44 5
Explore
existential-birds/beagle

sqlalchemy-code-review

Reviews SQLAlchemy code for session management, relationships, N+1 queries, and migration patterns. Use when reviewing SQLAlchemy 2.0 code, checking session lifecycle, relationship() usage, or Alembic migrations.

44 5
Explore
existential-birds/beagle

fastapi-code-review

Reviews FastAPI code for routing patterns, dependency injection, validation, and async handlers. Use when reviewing FastAPI apps, checking APIRouter setup, Depends() usage, or response models.

44 5
Explore
existential-birds/beagle

pytest-code-review

Reviews pytest test code for async patterns, fixtures, parametrize, and mocking. Use when reviewing test_*.py files, checking async test functions, fixture usage, or mock patterns.

44 5
Explore
existential-birds/beagle

postgres-code-review

Reviews PostgreSQL code for indexing strategies, JSONB operations, connection pooling, and transaction safety. Use when reviewing SQL queries, database schemas, JSONB usage, or connection management.

44 5
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results