ios-app-intents

Expose iOS app actions as App Intents to Shortcuts, Siri, Spotlight, and widgets.

7|8|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/omarshahine/Apple-PIM-Agent-Plugin --skill ios-app-intents-omarshahine
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ios-app-intents
Source: https://github.com/omarshahine/Apple-PIM-Agent-Plugin/tree/main/.claude/skills/ios-app-intents
Command: npx skills add https://github.com/omarshahine/Apple-PIM-Agent-Plugin --skill ios-app-intents-omarshahine

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Enable apps to expose meaningful actions and data to system surfaces like Shortcuts, Siri, Spotlight, and widgets by using App Intents, AppEntity types, and EntityQuery patterns, enabling automation, deep linking, and richer user workflows outside the UI.

Core Features & Use Cases

  • Define lightweight AppIntents for core app actions (open-app handoff or inline actions) to drive automation and shortcuts.
  • Create AppEntity types and EntityQuery implementations to model and discover app data for widgets, Siri, and Spotlight.
  • Provide AppShortcutsProvider entries to surface commonly-used intents with user-facing phrases, titles, and icons.
  • Route runtime handoff back into the app to preserve context and security while enabling seamless user flows.

Quick Start

Configure your first Open-Apps Intent with an openAppWhenRun handoff to launch the app and test an accompanying Shortcut phrase.

Frequently Asked Questions about ios-app-intents

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

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

To expose iOS app actions to Shortcuts and Siri, define AppEntity types, implement EntityQuery patterns, and provide AppShortcutsProvider entries that surface your app's core actions with user-facing phrases and icons.

What is an AppEntity and EntityQuery in iOS?

An AppEntity models your app's data types, while an EntityQuery discovers and fetches that data for system surfaces like Siri, Spotlight, and widgets. Together they enable Shortcuts to search and interact with your app's specific content.

How do I route App Intents runtime handoff back into my main app?

Route App Intents runtime handoff back into the main app by configuring an openAppWhenRun handoff. This preserves context and security while enabling seamless user flows for workflows like scheduling, reminders, contacts, and mail.

Can I use App Intents to model app data for Spotlight and widgets?

Yes, App Intents supports modeling app data for Spotlight and widgets. By creating AppEntity types and EntityQuery implementations, you enable system surfaces to discover and display your app's data for richer user workflows outside the UI.

What is the best way to define commonly used intents for Shortcuts?

The best way to define commonly used intents is by providing AppShortcutsProvider entries. This surfaces frequently used App Intents with user-facing phrases, titles, and icons for easy access in Siri and Shortcuts.

Do I need AppShortcutsProvider to surface intents with Siri phrases?

Yes, you need AppShortcutsProvider to surface intents with Siri phrases. It provides the necessary entries to expose commonly used App Intents with user-facing phrases, titles, and icons for Siri integration.