app-intents
installsforks
How to install app-intents?
rshankras/claude-code-apple-skills/app-intents
$npx -y skills add rshankras/claude-code-apple-skills --skill app-intentsApp Intents for Siri, Shortcuts, Spotlight, and Apple Intelligence integration including intent modes, interactive snippets, visual intelligence, and entity indexing. Use when implementing Siri integration, App Shortcuts, or Spotlight indexing.
SKILL.md
| 1 | # App Intents |
| 2 | |
| 3 | Build intents that expose your app's functionality to Siri, Shortcuts, Spotlight, and Apple Intelligence. Covers the full App Intents framework from basic actions through advanced features like interactive snippets, intent modes, visual intelligence integration, and Spotlight entity indexing. |
| 4 | |
| 5 | ## When This Skill Activates |
| 6 | |
| 7 | - User wants to add Siri or Shortcuts integration |
| 8 | - User asks about App Intents, AppIntent, or AppEntity |
| 9 | - User needs Spotlight indexing for app content |
| 10 | - User wants to create App Shortcuts with voice phrases |
| 11 | - User is implementing interactive snippets for Siri results |
| 12 | - User asks about intent modes (foreground, background) |
| 13 | - User needs visual intelligence integration via App Intents |
| 14 | - User wants onscreen entity support for Siri/ChatGPT |
| 15 | - User asks about Swift package support for App Intents |
| 16 | |
| 17 | ## Decision Tree |
| 18 | |
| 19 | ``` |
| 20 | What do you need? |
| 21 | | |
| 22 | +-- Expose an action to Siri/Shortcuts |
| 23 | | +-- Simple action, no UI needed |
| 24 | | | --> Basic AppIntent (intents-basics.md) |
| 25 | | +-- Needs to show UI or ask user questions |
| 26 | | | --> Intent Modes + Interactive Snippets (advanced-features.md) |
| 27 | | +-- Needs a predictable voice phrase |
| 28 | | --> App Shortcuts (intents-basics.md) |
| 29 | | |
| 30 | +-- Make content searchable |
| 31 | | +-- In Spotlight |
| 32 | | | --> IndexedEntity + @Property (entities-spotlight.md) |
| 33 | | +-- Runnable from Spotlight on Mac |
| 34 | | | --> parameterSummary visibility gates (entities-spotlight.md) |
| 35 | | +-- In Visual Intelligence |
| 36 | | | --> IntentValueQuery + SemanticContentDescriptor (advanced-features.md) |
| 37 | | +-- As onscreen entities for Siri/ChatGPT |
| 38 | | --> annotation APIs + EntityIdentifier (advanced-features.md) |
| 39 | | |
| 40 | +-- Let Siri execute intents from natural language |
| 41 | | --> App Schemas: @AppIntent(schema:) / @AssistantIntent (advanced-features.md) |
| 42 | | |
| 43 | +-- Feed entities to Apple Intelligence (Use Model action) |
| 44 | | --> AttributedString params + entity JSON + Find actions (entities-spotlight.md) |
| 45 | | |
| 46 | +-- Hand entities to other apps as content/files |
| 47 | | --> Transferable / FileEntity (entities-spotlight.md) |
| 48 | | |
| 49 | +-- Show rich results in Siri |
| 50 | | +-- Static display only |
| 51 | | | --> .result(view:) snippet (advanced-features.md) |
| 52 | | +-- Interactive buttons/controls |
| 53 | | | --> SnippetIntent protocol (advanced-features.md) |
| 54 | | +-- Custom spoken dialog |
| 55 | | --> IntentDialog(full:supporting:) (advanced-features.md) |
| 56 | | |
| 57 | +-- Present choices to the user |
| 58 | | --> requestChoice(between:) (advanced-features.md) |
| 59 | | |
| 60 | +-- Teach Siri from in-app UI actions |
| 61 | | --> IntentDonationManager (advanced-features.md) |
| 62 | | |
| 63 | +-- Share intents via Swift Package |
| 64 | --> AppIntentsPackage protocol (advanced-features.md) |
| 65 | ``` |
| 66 | |
| 67 | ## API Availability |
| 68 | |
| 69 | | Feature | Minimum OS | Framework | |
| 70 | |---------|-----------|-----------| |
| 71 | | `AppIntent` protocol | iOS 16 / macOS 13 | AppIntents | |
| 72 | | `AppEntity` protocol | iOS 16 / macOS 13 | AppIntents | |
| 73 | | `AppShortcutsProvider` | iOS 16 / macOS 13 | AppIntents | |
| 74 | | `@Parameter` macro | iOS 16 / macOS 13 | AppIntents | |
| 75 | | `IndexedEntity` protocol | iOS 18 / macOS 15 | AppIntents | |
| 76 | | `@Property` with `indexingKey` | iOS 18 / macOS 15 | AppIntents | |
| 77 | | Intent Modes (`supportedModes`) | iOS 26 / macOS 26 | AppIntents | |
| 78 | | `requestChoice(between:)` | iOS 26 / macOS 26 | AppIntents | |
| 79 | | `@ComputedProperty` | iOS 26 / macOS 26 | AppIntents | |
| 80 | | `@DeferredProperty` | iOS 26 / macOS 26 | AppIntents | |
| 81 | | `SnippetIntent` protocol | iOS 26 / macOS 26 | AppIntents | |
| 82 | | `AppIntentsPackage` protocol | iOS 26 / macOS 26 | AppIntents | |
| 83 | | Onscreen entities (`.userActivity()`) | iOS 26 / macOS 26 | AppIntents | |
| 84 | | `@UnionValue` | iOS 18 / macOS 15 | AppIntents | |
| 85 | | Assistant Schemas (`@AssistantIntent`) | iOS 18 | AppIntents | |
| 86 | | `Transferable` entities, `FileEntity` | iOS 18 / macOS 15 | AppIntents | |
| 87 | | `UndoableIntent` | iOS 26 / macOS 26 | AppIntents | |
| 88 | | App Schemas on `@AppIntent(schema:)` | iOS 27 / macOS 27 | AppIntents | |
| 89 | | `IntentDonationManager`, `OwnershipProvidingEntity` | iOS 27 / macOS 27 | AppIntents | |
| 90 | | AppIntentsTesting framework | Xcode 26 cycle (WWDC26) | AppIntentsTesting | |
| 91 | |
| 92 | ## Quick Reference |
| 93 | |
| 94 | | Task | Type/API | Reference File | |
| 95 | |------|----------|----------------| |
| 96 | | Define an action | `AppIntent` protocol | `intents-basics.md` | |
| 97 | | Accept parameters | `@Parameter` macro | `intents-basics.md` | |
| 98 | | Create voice phrases | `AppShortcutsProvider` | `intents-basics.md` | |
| 99 | | Define a data entity | `AppEntity` protocol | `entities-spotlight.md` | |
| 100 | | Index in Spotlight | `IndexedEntity` protocol | `entities-spotlight.md` | |
| 101 | | Mark indexable fields | `@Property(indexingKey:)` | `entities-spotlight.md` | |
| 102 | | Run in background/foreground | `supportedMo |
People who liked this also viewed
6 picksType
- hyperframes-cliUse the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, SkillsJul 2026
- request-refactor-planSkills for Real Engineers. Straight from my .agents directory.SkillsJul 2026
- analyze-projectRigor Analyze / Rigor Audit read-only skill for deep learning research repositories. Use when the user wants to read and understand a repository, inspect model structure and training or inference entrSkillsMay 2026
- explore-codeRigor Improve implementation leaf skill for auditable candidate implementation in deep learning research repositories. Use when the researcher explicitly authorizes exploratory work on an isolated braSkillsMay 2026
- ubiquitous-languageSkills for Real Engineers. Straight from my .agents directory.SkillsJul 2026
- scaffold-exercisesSkills for Real Engineers. Straight from my .agents directory.SkillsJul 2026
