/axiom-integration

name: axiom-integration
description: Use when work crosses into Apple's system surfaces rather than your own UI or data — Siri and Shortcuts, widgets, Live Activities, in-app purchase, localization, privacy prompts, alarms, timers, calendar, reminders, contacts, SharePlay, VoIP and CallKit, accessory pairing, weather, Spotlight indexing, background tasks, Background Assets, push, or push on networks with no internet.
license: MIT

iOS System Integration

**You MUST use this skill for ANY iOS system integration including Siri, Shortcuts, widgets, in-app purchases, background tasks, push notifications, and more.**

<!-- AXIOM_AUDITOR_INLINE_BEGIN — rewritten for Codex by scripts/build-codex.ts; do not hand-edit --> > **Auditors are skills here.** Where this router says "Launch `some-auditor` agent", invoke the > matching Codex skill instead — same procedure, no Claude Code agent required. > > Available: `axiom-audit-iap`, `axiom-audit-siri-ai`, `axiom-scan-security-privacy`. > > The ones that shell out — builds, tests, simulators, crash symbolication — need shell access to run. <!-- AXIOM_AUDITOR_INLINE_END -->

Quick Reference

| Symptom / Task | Reference | |----------------|-----------| | App Intents API lookup — a specific type, protocol, or modifier (writing or reviewing intents → `skills/app-intents.md` first; audio apps → `skills/siri-audio.md`) | See `skills/app-intents-ref.md` | | Writing or reviewing ANY App Intent, entity, or query — cold-launch `@Dependency` crash, `perform()` running twice, errors Siri shows as generic, results the system can't see, donations, `AppEnum` raw values, stable entity ids, long-running intents | See `skills/app-intents.md` | | Siri AI or Apple Intelligence calling custom actions — `@AppIntent(.tool)`, `ToolIntent`, `@AppEntity(.generable)`, property `description:`/`visibility:`, card snippets, `Skills.skillsbundle` App Skills, `sirimetadataanalyzer`, "make my app work with Siri AI" (27.3) | See `skills/siri-ai.md` | | Testing how Siri uses the app — SiriEvaluations, `SiriScenario`, `UserTurn`, `Calls`/`Finds`/`Loads` expectations, Siri evaluation reports (27.3) | See `skills/siri-evaluations-ref.md` | | Siri playback in an audio app ("play X in MyApp"), `.audio.*` schemas, `AudioSearch`, `INPlayMediaIntent` | See `skills/siri-audio.md` | | Audio schema members, parameters, enum cases, build errors; SiriKit media setup and authorization | See `skills/siri-audio-ref.md` | | Any schema domain's required parameters, properties, enum cases, return types, deprecated schemas; `Missing required parameter`/`property` and other schema build errors | See `skills/app-schemas-ref.md` | | Notes, to-do, or list app and Siri — SiriKit Lists/Notes (`INAddTasksIntent`, `INCreateNoteIntent`) deprecated in 27, `.notes.*`/`.reminders.*` schemas, watchOS | See `skills/siri-notes-reminders.md` | | Siri audio playback fails — "I can't play that", "hasn't added support for that with Siri", works only while the app is open, duplicate results | See `skills/siri-audio-diag.md` | | App Shortcuts, phrases, Spotlight | See `skills/app-shortcuts-ref.md` | | App discoverability strategy | See `skills/app-discoverability.md` | | Core Spotlight indexing | See `skills/core-spotlight-ref.md` | | LLM search over app content, SpotlightSearchTool | See `skills/core-spotlight-ref.md` | | Widgets, Control Center controls | See `skills/extensions-widgets.md` | | Widget API reference | See `skills/extensions-widgets-ref.md` | | Live Activities, Dynamic Island, push-to-start, broadcast | See `skills/live-activities.md` | | Live Activities / ActivityKit API reference | See `skills/live-activities-ref.md` | | Apple Pay (physical goods, services, donations) | **Use `axiom-payments` instead** | | In-app purchases, subscriptions | See `skills/in-app-purchases.md` | | StoreKit 2 API reference | See `skills/storekit-ref.md` | | Commitment billing plans, subscription bundles/suites, group/volume subscriptions, retention offers, offer codes | See `skills/storekit-ref.md` | | In-game content (Unity plug-ins, asset packs + IAP) | See `skills/in-app-purchases.md`, `skills/background-assets.md` | | The system Calendar and Reminders stores (EventKit) | See `skills/eventkit.md` | | EventKit API reference | See `skills/eventkit-ref.md` | | Contacts, contact picker | See `skills/contacts.md` | | Contacts API reference | See `skills/contacts-ref.md` | | Localization, String Catalogs | See `skills/localization.md` | | Apple terminology matching, glossary, pseudolocalization, TMS | See `skills/localization-research-ref.md` | | Privacy manifests, permissions UX | See `skills/privacy-ux.md` | | Bluetooth/Wi-Fi accessory pairing (AccessorySetupKit, iOS 18+) | See `skills/accessorysetupkit.md` | | AccessorySetupKit API (descriptor fields, events, auth-settings flow) | See `skills/accessorysetupkit-ref.md` | | Measure distance/direction to a paired accessory (Bluetooth Channel Sounding, iOS 27) | See `skills/accessorysetupkit-ref.md` (Part 7) | | Weather data, forecasts, attribution (WeatherKit) | See `skills/weatherkit.md` | | VoIP calls, CallKit, VoIP push, caller ID/blocking | See `skills/callkit-livecommunicationkit.md` | | CallKit / LiveCommunicationKit / IdentityLookup API reference | See `skills/callkit-livecommunicationkit-ref.md` | | SharePlay, GroupActivities, shared sessions, spatial Personas | See `skills/shareplay.md` | | GroupActivities API reference (GroupSession, messenger, journal) | See `skills/shareplay-ref.md` | | SharePlay coordinated audio/video playback | Use axiom-media (`skills/shareplay-playback.md`) instead | | Suggested actions for a messaging conversation (`SuggestedActionsView`, `com.apple.developer.suggested-actions` entitlement, `OS27`) | Use axiom-ai (skills/suggested-actions.md) instead — Apple-Intelligence-backed; the entitlement/capability is the integration half | | AlarmKit (iOS 26+) | See `skills/alarmkit-ref.md` | | Timer patterns, scheduling | See `skills/timer-pat