Index of every page on this site: llms.txt
All skills
Run it yourself

AlarmKit integration for scheduling alarms and timers with custom UI, Live Activities, and snooze support. Use when implementing alarm or timer features in iOS 26+ apps.

Use this Skill: https://skilld.dev/gh/rshankras/claude-code-apple-skills/alarmkit

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈45 tokens for metadata: the name and description. ≈1.2k when used: this file. ≈5k more on demand in 3 files.

Description uses 2.3% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈180 characters, or 2.3%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

AlarmKit

Framework for scheduling alarms and countdown timers with custom UI, Live Activities integration, and focus/silent mode override. Prevents the most common mistakes: using the wrong authorization property name, omitting the Info.plist key, and forgetting the widget extension for countdown presentations.

When This Skill Activates

Use this skill when the user:

  • Asks to add, fix, or review alarm or timer functionality
  • Mentions AlarmKit, AlarmManager, or AlarmPresentation
  • Wants to schedule one-time, repeating, or countdown alarms
  • Asks about snooze, stop, or repeat buttons on alarm alerts
  • Wants alarms to appear on Dynamic Island or Lock Screen (Live Activities)
  • Mentions overriding Focus or silent mode for alarms
  • Asks about AlarmAttributes or AlarmMetadata

Decision Tree

Choose the right reference file based on what the user needs:

What do you need?
|
+-- Schedule an alarm (one-time, repeating, or timer)
|   --> scheduling.md
|       +-- One-time alarm: Alarm.Schedule.relative + .repeats: .never
|       +-- Repeating alarm: Alarm.Schedule.relative + .repeats: .weekly(weekdays)
|       +-- Countdown timer: CountdownDuration (no schedule)
|       +-- Authorization & Info.plist setup
|       +-- Managing alarms: pause, resume, cancel
|
+-- Customize alarm UI (alert, countdown, paused screens)
|   --> presentation.md
|       +-- AlarmPresentation.Alert: title, stop, snooze/repeat buttons
|       +-- AlarmPresentation.Countdown: title, pause button
|       +-- AlarmPresentation.Paused: title, resume button
|       +-- Custom buttons with AlarmButton
|       +-- Tint color and metadata via AlarmAttributes
|
+-- Show alarm on Dynamic Island / Lock Screen
    --> live-activities.md
        +-- Widget extension with ActivityConfiguration
        +-- AlarmAttributes conformance
        +-- Custom AlarmMetadata protocol

API Availability

API Minimum Version Reference
AlarmManager iOS 26 scheduling.md
Alarm / Alarm.Schedule iOS 26 scheduling.md
AlarmPresentation (.alert, .countdown, .paused) iOS 26 presentation.md
AlarmAttributes iOS 26 live-activities.md
AlarmMetadata iOS 26 live-activities.md
AlarmButton iOS 26 presentation.md
CountdownDuration iOS 26 scheduling.md
alarmUpdates async sequence iOS 26 scheduling.md
authorizationUpdates async sequence iOS 26 scheduling.md

Top Mistakes -- Quick Reference

# Mistake Fix Details
1 Using .authorizationStatus instead of .authorizationState The property is AlarmManager.shared.authorizationState -- there is no authorizationStatus scheduling.md
2 Forgetting NSAlarmKitUsageDescription in Info.plist Add the key with a user-facing string before calling requestAuthorization() scheduling.md
3 Creating countdown timer with a schedule Timers use CountdownDuration only -- do not pass a schedule scheduling.md
4 Missing widget extension for countdown presentations Countdown and paused UI requires an ActivityConfiguration(for: AlarmAttributes.self) widget live-activities.md
5 Not persisting alarm UUIDs Store the Alarm.id (UUID) so you can pause, resume, or cancel later scheduling.md
6 Not observing alarmUpdates for state sync Use the alarmUpdates async sequence to keep local state in sync with the system scheduling.md

Review Checklist

When reviewing AlarmKit code, verify:

  • Info.plist -- NSAlarmKitUsageDescription is present with a meaningful description
  • Authorization -- requestAuthorization() is called before scheduling; denial is handled gracefully
  • Correct property -- uses .authorizationState, not .authorizationStatus
  • Alarm ID persistence -- alarm UUIDs are stored (e.g., UserDefaults, SwiftData) for later management
  • State observation -- alarmUpdates async sequence is used to keep UI in sync
  • Widget extension -- exists if countdown or paused presentations are used
  • Error handling -- schedule(), pause(), resume(), cancel() calls handle errors
  • System limits -- code accounts for the system limit on number of active alarms
  • Real device testing -- alarms are tested on physical devices, not just Simulator

Reference Files

File Content
scheduling.md Authorization, one-time/repeating/timer creation, managing alarms, observing updates
presentation.md Alert, countdown, paused UI customization, buttons, tint color
live-activities.md Widget extension, AlarmAttributes, AlarmMetadata, Dynamic Island

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts22d3 checks · Risk SAFE
  • Gen Agent Trust Hub22d

    The skill provides comprehensive and safe documentation for integrating the AlarmKit framework in iOS apps. It follows standard iOS development practices, including appropriate authorization handling and system requirements.

  • Socket22d

    No alerts

  • Snyk22d

    Risk: LOW · No issues

Signed by skilld at f958982. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last week.

Activeupdated 4 months ago
What it can do
Reads files
last_verified
2026-07-16
review_by
2027-06-22
os_version
iOS 27 / macOS 27
All 3 allowed tools
ReadGlobGrep

README badge

README badge for rshankras/claude-code-apple-skills/alarmkit