app-intents · dpearson2699 — Claude Code skill: App Intents for iOS
A skill for App Intents on iOS: turn app actions and data into Siri commands, Shortcuts, Spotlight results, widgets and Control Center controls.
npx skills add dpearson2699/swift-ios-skills --skill app-intents -a claude-codeWhat app-intents does
The skill runs App Intents through four steps: pick an action and its system surface, model the data, implement perform(), then check the result in that same surface. A table ties each protocol to an iOS version, from AppIntent on iOS 16 through ControlConfigurationIntent and IndexedEntity on iOS 18.
Sections cover @Parameter value types and initializer variants, AppEntity shadow models marked with @Property, the four EntityQuery variants, AppEnum, and the AppShortcutsProvider phrases that put an action in front of Siri. A common-mistakes list and a review checklist close it out, and references/appintents-advanced.md holds the remaining initializer forms.
Siri phrases get checked in the Xcode intent preview, so with no Xcode you end up with code and a checklist rather than a run against the live surface. SnippetIntent and IntentValueQuery arrive in iOS 26 and will not compile on an older deployment target.
What it helps with
- expose an app action to Siri and Shortcuts
- model an
AppEntityshadow type with@Propertyfields - pick the right
EntityQueryvariant for ID lookup or search - index entities in Spotlight with
IndexedEntityandindexingKey - wire a configurable widget through
WidgetConfigurationIntent
Example prompts for the agent
- Add an order intent with
soupandquantityparameters and aparameterSummaryfor Shortcuts - Review my
AppEntityandEntityQuery: too much internal data is reaching the system - Give this action a Siri phrase through
AppShortcutsProviderand index the entities for Spotlight
How to install app-intents
1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill app-intents -a claude-code2Manually: put the files in place
~/.claude/skills/app-intents/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/app-intents/
1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill app-intents -a codex2Manually: put the files in place
.agents/skills/app-intents/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill app-intents -a cursor2Manually: put the files in place
.cursor/skills/app-intents/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dpearson2699/swift-ios-skills app-intents2Manually: put the files in place
.github/skills/app-intents/SKILL.md1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill app-intents -a gemini-cli2Platform CLI
gemini skills install https://github.com/dpearson2699/swift-ios-skills --path skills/app-intentsManually: put the files in place
.devin/skills/app-intents/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill app-intents -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about app-intents
How do I install app-intents in Claude Code?
Run npx skills add dpearson2699/swift-ios-skills --skill app-intents -a claude-code. The skill then sits at ~/.claude/skills/app-intents/SKILL.md.
What does app-intents do?
It maps app actions and entities onto App Intents: which protocol fits each system surface, how @Parameter inputs are declared, which EntityQuery variant to use, and how Siri learns the phrases.
Which iOS versions does it cover?
The protocol table starts at AppIntent on iOS 16, then WidgetConfigurationIntent on iOS 17, ControlConfigurationIntent and IndexedEntity on iOS 18, with SnippetIntent and IntentValueQuery on iOS 26.
Similar skills
Everything for Mobile →app-intents by other authors comes first.
