UserNotifications

Local and remote (push) notifications on Apple platforms. The deep API reference — authorization, every trigger type, content/attachments, categories and actions, the delegate, APNs registration, badge management, and worked use cases — lives in references/guide.md. This file is the decision and discipline layer: read it first, open the guide for specifics.

Dials

Set these explicitly at the start; they change what "correct" means.

1. DELIVERY — local (default; you schedule via UNUserNotificationCenter.add with a trigger) · remote (APNs push: requires the Push Notifications capability, registerForRemoteNotifications, a server, and a device-token round-trip) · both (local for app-side reminders, remote for server-driven events — they share one delegate and one authorization).
2. AUTH_LEVEL — standard ([.alert, .sound, .badge], prompts once) · provisional (.provisional, delivers quietly to Notification Center with no prompt; user promotes later) · critical (.criticalAlert + defaultCriticalSound, bypasses mute/Focus — requires a special Apple entitlement, do not request without one).
3. INTERRUPTION — passive (silent, list only) · active (default) · timeSensitive (breaks through Focus — needs the Time Sensitive Notifications entitlement) · critical (bypasses mute, entitlement-gated). Pick per notification, not per app.

When to use

Building or reviewing any code that requests notification permission, schedules local notifications, registers for or handles push, defines categories/actions, implements UNUserNotificationCenterDelegate, or manages the app badge. If notifications are delivered by a third-party SDK (e.g. a push provider's wrapper), still use this skill for the authorization, delegate, and category layer — those remain UserNotifications.

Core rules