app-intents

Implement App Intents for Siri, Shortcuts, Spotlight, widgets, Control Center, and Apple Intelligence on iOS. Covers AppIntent actions, AppEntity and EntityQuery models, AppShortcutsProvider phrases, IndexedEntity Spotlight indexing, WidgetConfigurationIntent, SnippetIntent, and assistant schemas. Use when exposing app actions or entities to system surfaces.

741stars40forksUpdated 6/15/2026

Developer Tools #ios #apple-intelligence #siri #shortcuts #swift #widgets

Security Assessment

Safe(100/100)

Security Score100/100

About app-intents

The app-intents skill enables implementation and integration of App Intents for iOS applications, allowing developers to expose app functionality to system-level features including Siri, Shortcuts, Spotlight search, widgets, Control Center, and Apple Intelligence. This skill addresses the challenge of making app actions and data discoverable and actionable across the iOS ecosystem, transforming isolated app features into system-wide capabilities that users can invoke through voice commands, automation workflows, and intelligent suggestions.

The skill covers the complete App Intents framework including AppIntent protocol implementation for defining actions, AppEntity and EntityQuery for modeling and resolving data entities, AppShortcutsProvider for registering Siri phrases, IndexedEntity for Spotlight integration, WidgetConfigurationIntent for configurable widgets, and iOS 18+ features like Control Center widgets and Apple Intelligence schemas. It provides structured guidance on parameter declaration with @Parameter, entity querying strategies across four variants, and integration patterns for interactive widgets and snippet intents introduced in iOS 26.

This skill is designed for iOS developers building apps that need to integrate with system surfaces, particularly those implementing Siri voice commands, Shortcuts automation, widget configuration, or Apple Intelligence features. It's valuable for teams modernizing existing apps to support system-wide discoverability, developers building productivity or automation-focused applications, and anyone creating apps where user actions should be accessible beyond the traditional app interface through voice, search, or intelligent suggestions.

FAQ

What iOS version is required for App Intents?

App Intents require iOS 16 or later for basic Siri and Shortcuts integration. Advanced features like Control Center widgets and Apple Intelligence require iOS 18+, while SnippetIntent and Visual Intelligence features require iOS 26+.

When should I use AppEntity versus passing raw data types?

Use AppEntity shadow models when exposing app data to system surfaces like Siri, Shortcuts, or Spotlight. AppEntity provides proper identity, display representation, and query resolution that the system needs to present and resolve your data across different contexts.

What's the difference between the four EntityQuery variants?

The skill covers four EntityQuery variants for different data resolution scenarios: basic entity lookup, filtered queries, paginated results, and dynamic entity discovery. Choose the variant based on your data source characteristics and how users will search or filter entities.

How do I make my app's content searchable in Spotlight?

Mark entities with IndexedEntity protocol and provide an indexingKey metadata. Index instances to a named Spotlight index so they appear in system search results and can be referenced in Shortcuts and Siri interactions.

What are common mistakes when implementing App Intents?

The skill includes a review checklist covering common mistakes such as improper parameter handling, missing parameterSummary for Shortcuts UI, incorrect EntityQuery variant selection, and failure to register AppShortcutsProvider phrases for Siri discoverability.