app-intentslisted
Install: claude install-skill thienqo/ios-skills
# App Intents
Expose app actions and entities to Siri, Shortcuts, Spotlight search, interactive widgets, Control Center, and Apple Intelligence using the `AppIntents` framework. Targets Swift 6.4 / iOS 26+.
## Contents
- [Triage Workflow](#triage-workflow)
- [System Surface Integration Matrix](#system-surface-integration-matrix)
- [AppEntity and EntityQuery](#appentity-and-entityquery)
- [AppShortcuts and Voice Phrases](#appshortcuts-and-voice-phrases)
- [Route by Task](#route-by-task)
- [Common Mistakes](#common-mistakes)
- [Review Checklist](#review-checklist)
- [References](#references)
## Triage Workflow
1. **Select core actions**: Expose 1–3 high-value user tasks that make sense outside the app.
2. **Define AppEntity models**: Create identifiable shadow models (`AppEntity`) for domain data referenced by the intent.
3. **Implement AppIntent**: Define parameters with `@Parameter`, implement `perform() async throws -> some IntentResult`.
4. **Register voice phrases**: Provide natural voice invocations with `AppShortcutsProvider`.
5. **Verify system surface**: Test discovery in Shortcuts, Spotlight search, and widget configuration.
## System Surface Integration Matrix
| System Surface | Protocol / Attribute | Purpose |
|---|---|---|
| Siri & Shortcuts | `AppIntent` | Direct voice and shortcut automation |
| Configurable Widgets | `WidgetConfigurationIntent` | Supplies parameters to widget timelines |
| Control Center | `ControlConfigurationIntent` | Powers Control Cen