App Intents Expert Skill
Expert guidance for the App Intents framework on iOS 26+. This skill covers building intents, entities, queries, App Shortcuts, interactive snippets, and integrating with Siri, Spotlight, Apple Intelligence, and Visual Intelligence.
When to use this skill
Use this skill when the developer is:
- Creating or modifying any
AppIntent, AppEntity, AppEnum, or EntityQuery
- Adding Siri, Shortcuts, Spotlight, or Apple Intelligence support to an app
- Building
AppShortcutsProvider or App Shortcuts
- Implementing interactive snippets with
SnippetIntent
- Indexing entities for Spotlight with
IndexedEntity
- Integrating with Visual Intelligence or image search
- Navigating with
TargetContentProvidingIntent and onAppIntentExecution
- Migrating from SiriKit (
INIntent) to App Intents
- Debugging App Intents build errors or runtime issues
Task-based routing
Based on what the developer needs, read the relevant reference files.
"I want to create my first App Intent"
- Read references/intent-fundamentals.md
- Then references/shortcuts-provider.md for discoverability
"I want my app's content searchable in Siri and Spotlight"
- Read references/entities-and-queries.md
- Then references/spotlight-indexing.md
- Then references/siri-integration.md
"I want to integrate with Apple Intelligence and the new Siri"
- Read references/apple-intelligence.md
- Then references/siri-integration.md
- Then references/intent-fundamentals.md if new to the framework
"I want to build interactive snippets"
- Read references/interactive-snippets.md
- Then references/intent-fundamentals.md if not familiar with intents
"I want to add Shortcuts and Siri phrases to my app"
- Read references/shortcuts-provider.md
- Then references/siri-integration.md
"I want to structure my app around App Intents"
- Read references/intent-driven-architecture.md
- Then references/entities-and-queries.md
- Then references/intent-fundamentals.md
"I want to support Visual Intelligence / image search"
- Read references/apple-intelligence.md — image search section
- Then references/entities-and-queries.md
"I'm migrating from SiriKit"
- Read references/migration-from-sirikit.md
- Then references/intent-fundamentals.md
"I need to test my App Intents"
- Read references/testing-intents.md
"I'm hitting build errors or runtime issues"
- Read references/common-pitfalls.md
Quick-reference checklists
Minimum viable App Intent
Minimum viable App Entity
Minimum viable App Shortcut
Making an entity Spotlight-searchable
Adding interactive snippets (iOS 26+)
Key decision tree
Which protocol should my intent conform to?
Is it a basic action?
→ AppIntent
Does it open your app to show content?
→ OpenIntent + TargetContentProvidingIntent
Does it render an interactive view?
→ SnippetIntent
Should it support undo?
→ UndoableIntent
Does it match an Apple Intelligence domain?
→ Use @AppIntent macro with the appropriate schema
Which entity type should I use?
Is the set of values fixed and known at compile time?
→ AppEnum
Is the set of values dynamic?
→ AppEntity
Do I need Spotlight indexing?
→ AppEntity + IndexedEntity
Do I need image search / Visual Intelligence?
→ AppEntity + Transferable + OpenIntent
Which query type should I use?
Can all entities fit in memory?
→ EnumerableEntityQuery
Do I need text-based search?
→ EntityStringQuery
Do I need filtering by properties?
→ EntityPropertyQuery
Do I only need lookup by ID?
→ EntityQuery (base protocol)
Should a property be @Property, @ComputedProperty, or @DeferredProperty?
Is the value stored on the entity struct?
→ @Property
Can the value be derived from another source (UserDefaults, model)?
→ @ComputedProperty (preferred — lower overhead)
Is the value expensive to compute (network call, heavy I/O)?
→ @DeferredProperty (async getter, only called when system requests it)
Framework architecture notes
- App Intents uses build-time metadata extraction. Your Swift source code is read at compile time to generate an App Intents representation stored inside your app bundle. This is why certain values (titles, display representations) must be compile-time constants.
- The system reads this metadata without running your app. After installation, intents, entities, and shortcuts are available immediately.
- Each target in your app is processed independently. When sharing App Intent types across targets, use
AppIntentsPackage to register each target.
- App Intents can now live in Swift Packages and static libraries (new in iOS 26).
- Register dependencies with
AppDependencyManager.shared.add { } as early as possible in your app's lifecycle (typically in the App.init()).
1---2name: app-intents-expert-skill3description: Expert App Intents guidance for building Siri, Shortcuts, Spotlight, Apple Intelligence, and interactive snippet integrations on iOS 26+. Use when implementing AppIntent, AppEntity, AppEnum, EntityQuery, AppShortcutsProvider, SnippetIntent, SiriTipView, IndexedEntity, or when making an app work with Siri, Shortcuts, Spotlight, Apple Intelligence, Visual Intelligence, Action Button, or Apple Pencil. Also use when asked about App Intents architecture, intent-driven development, or migrating from SiriKit.4license: MIT5metadata:6 source: https://skillmd.com/skills/rudrankriyam/app-intents-expert-skill7 author: rudrankriyam8 version: "1.0"9---1011# App Intents Expert Skill1213Expert guidance for the App Intents framework on iOS 26+. This skill covers building intents, entities, queries, App Shortcuts, interactive snippets, and integrating with Siri, Spotlight, Apple Intelligence, and Visual Intelligence.1415## When to use this skill1617Use this skill when the developer is:18- Creating or modifying any `AppIntent`, `AppEntity`, `AppEnum`, or `EntityQuery`19- Adding Siri, Shortcuts, Spotlight, or Apple Intelligence support to an app20- Building `AppShortcutsProvider` or App Shortcuts21- Implementing interactive snippets with `SnippetIntent`22- Indexing entities for Spotlight with `IndexedEntity`23- Integrating with Visual Intelligence or image search24- Navigating with `TargetContentProvidingIntent` and `onAppIntentExecution`25- Migrating from SiriKit (`INIntent`) to App Intents26- Debugging App Intents build errors or runtime issues2728## Task-based routing2930Based on what the developer needs, read the relevant reference files.3132### "I want to create my first App Intent"331. Read [references/intent-fundamentals.md](references/intent-fundamentals.md)342. Then [references/shortcuts-provider.md](references/shortcuts-provider.md) for discoverability3536### "I want my app's content searchable in Siri and Spotlight"371. Read [references/entities-and-queries.md](references/entities-and-queries.md)382. Then [references/spotlight-indexing.md](references/spotlight-indexing.md)393. Then [references/siri-integration.md](references/siri-integration.md)4041### "I want to integrate with Apple Intelligence and the new Siri"421. Read [references/apple-intelligence.md](references/apple-intelligence.md)432. Then [references/siri-integration.md](references/siri-integration.md)443. Then [references/intent-fundamentals.md](references/intent-fundamentals.md) if new to the framework4546### "I want to build interactive snippets"471. Read [references/interactive-snippets.md](references/interactive-snippets.md)482. Then [references/intent-fundamentals.md](references/intent-fundamentals.md) if not familiar with intents4950### "I want to add Shortcuts and Siri phrases to my app"511. Read [references/shortcuts-provider.md](references/shortcuts-provider.md)522. Then [references/siri-integration.md](references/siri-integration.md)5354### "I want to structure my app around App Intents"551. Read [references/intent-driven-architecture.md](references/intent-driven-architecture.md)562. Then [references/entities-and-queries.md](references/entities-and-queries.md)573. Then [references/intent-fundamentals.md](references/intent-fundamentals.md)5859### "I want to support Visual Intelligence / image search"601. Read [references/apple-intelligence.md](references/apple-intelligence.md) — image search section612. Then [references/entities-and-queries.md](references/entities-and-queries.md)6263### "I'm migrating from SiriKit"641. Read [references/migration-from-sirikit.md](references/migration-from-sirikit.md)652. Then [references/intent-fundamentals.md](references/intent-fundamentals.md)6667### "I need to test my App Intents"681. Read [references/testing-intents.md](references/testing-intents.md)6970### "I'm hitting build errors or runtime issues"711. Read [references/common-pitfalls.md](references/common-pitfalls.md)7273## Quick-reference checklists7475### Minimum viable App Intent76- [ ] Create a struct conforming to `AppIntent`77- [ ] Add a `static let title: LocalizedStringResource`78- [ ] Implement `func perform() async throws -> some IntentResult`79- [ ] Add `@Parameter` for any inputs80- [ ] Add a `ParameterSummary` for all required parameters81- [ ] Set `supportedModes` if the intent should foreground the app8283### Minimum viable App Entity84- [ ] Create a struct conforming to `AppEntity`85- [ ] Add a persistent, unique `id` property86- [ ] Add `@Property` or `@ComputedProperty` for each exposed property87- [ ] Provide `typeDisplayRepresentation` and `displayRepresentation`88- [ ] Create an `EntityQuery` with `entities(for:)` method89- [ ] Set `static let defaultQuery` on the entity90- [ ] Register data dependencies with `AppDependencyManager`9192### Minimum viable App Shortcut93- [ ] Create an `AppShortcutsProvider` with `static var appShortcuts`94- [ ] Create `AppShortcut` instances with intent, phrases, shortTitle, systemImageName95- [ ] Every phrase must include `\(.applicationName)`96- [ ] At most one `@Parameter` per phrase97- [ ] Call `updateAppShortcutParameters()` when suggested entities change9899### Making an entity Spotlight-searchable100- [ ] Conform entity to `IndexedEntity`101- [ ] Add `indexingKey` parameter to `@Property` attributes102- [ ] Donate entities using the framework's indexing APIs103- [ ] Implement an `OpenIntent` so tapping results navigates to the entity104105### Adding interactive snippets (iOS 26+)106- [ ] Create a struct conforming to `SnippetIntent`107- [ ] Mark all view-driving variables as `@Parameter`108- [ ] Return `.result(view:)` from `perform()`109- [ ] Use `Button(intent:)` or `Toggle(intent:)` in the snippet view110- [ ] Return `ShowsSnippetIntent` from the parent intent111- [ ] Do NOT mutate app state in the snippet intent's perform method112113## Key decision tree114115### Which protocol should my intent conform to?116117```118Is it a basic action?119 → AppIntent120121Does it open your app to show content?122 → OpenIntent + TargetContentProvidingIntent123124Does it render an interactive view?125 → SnippetIntent126127Should it support undo?128 → UndoableIntent129130Does it match an Apple Intelligence domain?131 → Use @AppIntent macro with the appropriate schema132```133134### Which entity type should I use?135136```137Is the set of values fixed and known at compile time?138 → AppEnum139140Is the set of values dynamic?141 → AppEntity142143Do I need Spotlight indexing?144 → AppEntity + IndexedEntity145146Do I need image search / Visual Intelligence?147 → AppEntity + Transferable + OpenIntent148```149150### Which query type should I use?151152```153Can all entities fit in memory?154 → EnumerableEntityQuery155156Do I need text-based search?157 → EntityStringQuery158159Do I need filtering by properties?160 → EntityPropertyQuery161162Do I only need lookup by ID?163 → EntityQuery (base protocol)164```165166### Should a property be @Property, @ComputedProperty, or @DeferredProperty?167168```169Is the value stored on the entity struct?170 → @Property171172Can the value be derived from another source (UserDefaults, model)?173 → @ComputedProperty (preferred — lower overhead)174175Is the value expensive to compute (network call, heavy I/O)?176 → @DeferredProperty (async getter, only called when system requests it)177```178179## Framework architecture notes180181- App Intents uses **build-time metadata extraction**. Your Swift source code is read at compile time to generate an App Intents representation stored inside your app bundle. This is why certain values (titles, display representations) must be compile-time constants.182- The system reads this metadata **without running your app**. After installation, intents, entities, and shortcuts are available immediately.183- Each target in your app is processed independently. When sharing App Intent types across targets, use `AppIntentsPackage` to register each target.184- App Intents can now live in **Swift Packages and static libraries** (new in iOS 26).185- Register dependencies with `AppDependencyManager.shared.add { }` as early as possible in your app's lifecycle (typically in the `App.init()`).