App Intents

If you're wiring up Siri, Shortcuts, or widgets on iOS, this is your reference sheet. It walks through the four EntityQuery variants, parameter declarations, and the difference between AppIntent and its specialized cousins like WidgetConfigurationIntent and SnippetIntent. The triage workflow up front is smart: it maps each system surface to the right protocol before you start coding. Most helpful for keeping straight when to use AppEntity shadow models versus conforming your core types directly (spoiler: always shadow), and understanding why your parameter preview breaks when you forget a default value. Covers iOS 16 through the iOS 26 additions like Visual Intelligence integration.

skills.sh installs: 4.1K
GitHub stars: 1.3K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add dpearson2699/swift-ios-skills --skill app-intents --agent claude-code

Installs into .claude/skills of the current project.

Files

App Intents (iOS 26+)

Implement, review, and extend App Intents to expose app functionality to Siri, Shortcuts, Spotlight, widgets, Control Center, and Apple Intelligence.

Triage Workflow
AppIntent Protocol
@Parameter
AppEntity
EntityQuery (4 Variants)
AppEnum
AppShortcutsProvider
System Surface Integration
iOS 26 Additions
Common Mistakes
Review Checklist
References

Triage Workflow

Step 1: Choose the action, boundary, and surface

Start from 1-3 valuable actions people want outside the app, not from its screen hierarchy. Record one design row per action: user goal; inline result or app destination; shared domain operation; parameters and entity query; confirmation/authentication; target surface and protocol. Use one explicit runtime route for app handoff instead of scattering navigation side effects through intents.

Then choose the system feature and protocol that fit that action:

SKILL.md on GitHub