app-intents

Implement App Intents for Siri, Shortcuts, Spotlight, widgets, and Control Center.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/DFly7/iOS-FastAPI-Supabase-AI --skill app-intents-dfly7
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: app-intents
Source: https://github.com/DFly7/iOS-FastAPI-Supabase-AI/tree/main/.agents/skills/app-intents
Command: npx skills add https://github.com/DFly7/iOS-FastAPI-Supabase-AI --skill app-intents-dfly7

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Implementing and maintaining App Intents across Siri, Shortcuts, Spotlight, widgets, Control Center, and Apple Intelligence is complex and error-prone; this guide consolidates correct patterns so developers can reliably expose app features to system surfaces.

Core Features & Use Cases

  • Intent implementation patterns: how to declare AppIntent, parameter summaries, and perform() semantics with async/await.
  • Entity and query models: guidance for AppEntity, AppEnum, EntityQuery variants, EntityPropertyQuery, and UniqueAppEntityQuery for reliable resolution and suggestions.
  • System integrations: registering AppShortcutsProvider phrases, Spotlight indexing with IndexedEntity and indexingKey, WidgetConfigurationIntent and ControlConfigurationIntent configuration, SnippetIntent and IntentValueQuery usage for iOS 26+.
  • Operational concerns: authentication policies, error and confirmation flows, SiriKit migration strategies, and batching/indexing best practices.

Quick Start

Create an AppIntent with @Parameter properties, implement perform() using async/await, add a parameterSummary, register phrases in AppShortcutsProvider including the application name token, and expose searchable entities with IndexedEntity and indexingKey where appropriate.

Frequently Asked Questions about app-intents

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I expose app actions to Siri and Shortcuts using AppIntents?

To expose app actions to Siri and Shortcuts, declare an AppIntent with @Parameter properties, implement an async perform() method, provide a parameterSummary, and register phrases in AppShortcutsProvider including the application name token.

What is the best way to define AppEntity models for Spotlight indexing?

The best way to define AppEntity models for Spotlight indexing is to conform to IndexedEntity and assign an indexingKey, ensuring reliable entity resolution and system surface visibility across iOS 16 and later.

How do I configure widgets with WidgetConfigurationIntent in iOS?

You configure widgets with WidgetConfigurationIntent by defining an AppIntent that accepts parameters, then linking it to your WidgetConfiguration to allow dynamic user customization directly within the system UI.

Can I use AppIntents for SiriKit migration across older iOS versions?

Yes, you can use AppIntents for SiriKit migration by replacing deprecated SiriKit intents with AppIntent actions and AppEntity models, supporting system integrations across iOS 16 through 26+ scenarios.

How do I handle authentication and confirmation flows in AppIntents?

Handle authentication and confirmation flows in AppIntents by implementing authentication policies and confirmation dialogs within your AppIntent perform() execution path to secure sensitive user actions triggered via Siri.

Why does my AppEntity query fail to resolve parameters in Siri?

AppEntity query resolution in Siri fails when EntityQuery variants or UniqueAppEntityQuery conformances are incorrectly implemented, preventing the system from matching spoken parameters to your app's entities.