kvn8888/OpenFoodJournal / plugins/build-ios-apps/skills/ios-app-intents
ios-app-intents
VerifiedDesign App Intents, app entities, and App Shortcuts for iOS system surfaces. Use when exposing app actions or content to Shortcuts, Siri, Spotlight, widgets, or controls.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.5 KB |
| agents/openai.yaml | config | 113 B |
| references/code-templates.md | markdown | 7.4 KB |
| references/example-patterns.md | markdown | 3.6 KB |
| references/first-pass-checklist.md | markdown | 1.4 KB |
| references/system-surfaces.md | markdown | 1.0 KB |
references/example-patterns.md
View on GitHub# Example patterns
Use these as starting points when deciding what to expose first.
## 1) Open-app handoff intent
Best for:
- compose flows
- editors
- navigation to a destination
- actions that need the full app scene, auth state, or richer UI
Pattern:
- `openAppWhenRun = true`
- collect lightweight input in the intent
- store one handled-intent payload in a central router or handoff service
- let the app scene translate that payload into tabs, sheets, routes, or windows
Example:
- "Open the app to compose a draft"
- "Open the app on a selected section"
- "Open an editor prefilled with content from the previous shortcut step"
## 2) Inline background action intent
Best for:
- quick create/update actions
- send, archive, mark, favorite, or toggle operations
- actions that can finish without the main app UI
Pattern:
- `openAppWhenRun = false`
- perform the operation directly in `perform()`
- return dialog or snippet feedback so the result feels complete in Shortcuts or Siri
Example:
- "Create a task"
- "Send a message"
- "Archive a document"
## 3) Paired open-app and inline variants
Best for:
- actions that need both automation and richer manual review
- flows where some users want a background shortcut but others want to land in the app
Pattern:
- keep parameter names aligned between the two intents
- let the open-app version hand off to UI
- let the inline version call the same domain service directly
- expose both in `AppShortcutsProvider` with clear titles
Example:
- "Draft in app" and "Send now"
- "Open image post editor" and "Post images in background"
## 4) Fixed choice via `AppEnum`
Best for:
- tabs
- modes
- visibility levels
- small sets of filters or categories
Pattern:
- define an `AppEnum`
- give every case a user-facing `DisplayRepresentation`
- map enum cases into app-specific types in one place
Example:
- open a selected tab
- run an action in "public", "private", or "team" mode
## 5) Entity-backed selection via `AppEntity`
Best for:
- accounts
- projects
- lists
- destinations
- saved searches
Pattern:
- expose only the fields needed for display and lookup
- add `suggestedEntities()` for picker UX
- add `defaultResult()` only when there is a genuinely helpful default
- keep network or database fetch logic inside the query type, not the view layer
Example:
- choose an account to post from
- pick a project to open
- select a saved list for a widget
## 6) Query dependency between parameters
Best for:
- when one parameter changes the valid choices for another
- widget or control configuration where "account" determines "project"
Pattern:
- use `@IntentParameterDependency` inside the query
- read the upstream parameter
- scope entity fetching to the chosen parent value
Example:
- selected workspace filters available documents
- selected account filters available lists
## 7) Widget configuration intent
Best for:
- widgets that need a selected account, project, filter, or destination
- intent-driven controls that should reuse the same parameter model
Pattern:
- define a `WidgetConfigurationIntent`
- use the same `AppEntity` types that your shortcuts already use
- provide preview-friendly sample values when the widget needs them
Example:
- choose account plus list
- choose project plus status filter
## 8) Shortcut phrase design
Best for:
- making actions discoverable in Siri and Shortcuts
Pattern:
- keep phrases short and verb-led
- expose one or two canonical phrases, then add only a few natural variants
- use precise `shortTitle` and `systemImageName`
Example:
- "Create a note with \(.applicationName)"
- "Open inbox in \(.applicationName)"
- "Send image with \(.applicationName)"
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |