Apple Intelligence Skills
Skills for implementing Apple Intelligence features including on-device LLMs, visual recognition, App Intents integration, and intelligent assistants.
When This Skill Activates
Use this skill when the user:
- Wants to add AI/LLM features to their app
- Needs on-device text generation or understanding
- Asks about Foundation Models or Apple Intelligence
- Wants to implement structured AI output
- Needs prompt engineering guidance
- Wants camera-based visual intelligence features
- Needs Siri, Shortcuts, or Spotlight integration via App Intents
- Wants to expose app actions or content to the system
Available Skills
foundation-models/
On-device LLM integration with prompt engineering best practices.
- Model availability checking
- Session management
- @Generable structured output (property-order + schema-injection rules)
- Tool calling patterns
- Snapshot streaming
- Prompt engineering techniques
safety-and-guardrails.md — model limits, the instructions-over-prompts hierarchy, guardrail handling, the four-layer safety stack, evals
models-and-agents.md — Private Cloud Compute, LanguageModel protocol (third-party backends), vision input, DynamicProfile agents, tool-calling modes, KV-cache rules
visual-intelligence/
Integrate with iOS Visual Intelligence for camera-based search.
- IntentValueQuery implementation
- SemanticContentDescriptor handling
- AppEntity for searchable content
- Display representations
- Deep linking from results
app-intents/
App Intents for Siri, Shortcuts, Spotlight, and Apple Intelligence.
- AppIntent protocol, parameters, perform()
- AppEntity and entity queries
- App Shortcuts with voice phrases
- IndexedEntity and Spotlight indexing
- Intent modes (background, foreground)
- Interactive snippets with SnippetIntent
- Visual intelligence integration
- Onscreen entities for Siri/ChatGPT
- Multiple choice API
- Swift package support
Key Principles
1. Privacy First
- On-device processing by default; Private Cloud Compute extends capacity without storing prompts (no account/API keys — WWDC26 241)
- When routing to less-private backends, redact context first (see foundation-models/models-and-agents.md)
2. Graceful Degradation
- Always check model availability
- Provide fallback UI for unsupported devices
- Handle errors gracefully (incl. guardrail violations — silent for proactive features, explained for user-initiated)
3. Efficient Prompting
- Keep prompts focused and specific
- Use structured output when possible
- Respect context window limits — query
model.contextSize, never hardcode (4,096 first-gen on-device; 8,192 iOS 27 on-device; 32,000 Private Cloud Compute)
Reference Documentation
- Foundation Models
- Visual Intelligence
- App Intents
- Local captured docs (optional): if
~/Downloads/docs/ contains FoundationModels-Using-on-device-LLM-in-your-app.md, Implementing-Visual-Intelligence-in-iOS.md, or AppIntents-Updates.md, read them for extra detail; skip silently if absent.
1---
2name: apple-intelligence
3description: Apple Intelligence skills for on-device AI features including Foundation Models, Visual Intelligence, App Intents, and intelligent assistants. Use when implementing AI-powered features.
4allowed-tools: [Read, Write, Edit, Glob, Grep, Bash, AskUserQuestion]
5last_verified: 2026-07-16
6review_by: 2027-06-22
7os_version: iOS 27 / macOS 27
8---
9
10# Apple Intelligence Skills
11
12Skills for implementing Apple Intelligence features including on-device LLMs, visual recognition, App Intents integration, and intelligent assistants.
13
14## When This Skill Activates
15
16Use this skill when the user:
17- Wants to add AI/LLM features to their app
18- Needs on-device text generation or understanding
19- Asks about Foundation Models or Apple Intelligence
20- Wants to implement structured AI output
21- Needs prompt engineering guidance
22- Wants camera-based visual intelligence features
23- Needs Siri, Shortcuts, or Spotlight integration via App Intents
24- Wants to expose app actions or content to the system
25
26## Available Skills
27
28### foundation-models/
29On-device LLM integration with prompt engineering best practices.
30- Model availability checking
31- Session management
32- @Generable structured output (property-order + schema-injection rules)
33- Tool calling patterns
34- Snapshot streaming
35- Prompt engineering techniques
36- `safety-and-guardrails.md` — model limits, the instructions-over-prompts hierarchy, guardrail handling, the four-layer safety stack, evals
37- `models-and-agents.md` — Private Cloud Compute, LanguageModel protocol (third-party backends), vision input, DynamicProfile agents, tool-calling modes, KV-cache rules
38
39### visual-intelligence/
40Integrate with iOS Visual Intelligence for camera-based search.
41- IntentValueQuery implementation
42- SemanticContentDescriptor handling
43- AppEntity for searchable content
44- Display representations
45- Deep linking from results
46
47### app-intents/
48App Intents for Siri, Shortcuts, Spotlight, and Apple Intelligence.
49- AppIntent protocol, parameters, perform()
50- AppEntity and entity queries
51- App Shortcuts with voice phrases
52- IndexedEntity and Spotlight indexing
53- Intent modes (background, foreground)
54- Interactive snippets with SnippetIntent
55- Visual intelligence integration
56- Onscreen entities for Siri/ChatGPT
57- Multiple choice API
58- Swift package support
59
60## Key Principles
61
62### 1. Privacy First
63- On-device processing by default; Private Cloud Compute extends capacity without storing prompts (no account/API keys — WWDC26 241)
64- When routing to less-private backends, redact context first (see foundation-models/models-and-agents.md)
65
66### 2. Graceful Degradation
67- Always check model availability
68- Provide fallback UI for unsupported devices
69- Handle errors gracefully (incl. guardrail violations — silent for proactive features, explained for user-initiated)
70
71### 3. Efficient Prompting
72- Keep prompts focused and specific
73- Use structured output when possible
74- Respect context window limits — query `model.contextSize`, never hardcode (4,096 first-gen on-device; 8,192 iOS 27 on-device; 32,000 Private Cloud Compute)
75
76## Reference Documentation
77
78- [Foundation Models](https://developer.apple.com/documentation/foundationmodels)
79- [Visual Intelligence](https://developer.apple.com/documentation/visualintelligence)
80- [App Intents](https://developer.apple.com/documentation/appintents)
81- Local captured docs (optional): if `~/Downloads/docs/` contains `FoundationModels-Using-on-device-LLM-in-your-app.md`, `Implementing-Visual-Intelligence-in-iOS.md`, or `AppIntents-Updates.md`, read them for extra detail; skip silently if absent.