apple-foundation-models
Use this skill when working with Apple's Foundation Models framework for on-device AI and LLM capabilities in iOS/macOS apps
How do I install this agent skill?
npx skills add https://github.com/ios-agent/iosagent.dev --skill apple-foundation-modelsIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides comprehensive documentation and guidelines for working with Apple's Foundation Models framework in iOS and macOS applications. It includes instructions for on-device AI capabilities, dynamic schema generation, local tool calling, and proper error handling. No security issues or malicious behaviors were detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
11/11 files flagged
What does this agent skill do?
Apple Foundation Models Skill
When to Use This Skill
Use this skill when you need help with:
- On-device AI: Building iOS/macOS apps with on-device language models
- SystemLanguageModel: Working with Apple's on-device LLM API
- Guided Generation: Generating structured Swift types from prompts
- Tool Calling: Extending model capabilities with custom tools
- Prompting: Crafting effective prompts for on-device models
- Safety: Implementing guardrails and handling sensitive content
- Localization: Supporting multilingual AI features
This skill covers iOS 26.0+, iPadOS 26.0+, macOS 26.0+, and visionOS 26.0+.
Description
Use this skill when working with Apple's Foundation Models framework for on-device AI and LLM capabilities in iOS/macOS apps. Covers SystemLanguageModel, LanguageModelSession, guided generation, tool calling, and prompting patterns.
Quick Reference
Core Components
Advanced
TranscriptTranscript.EntryTranscript.ResponseTranscript.ResponseFormatTranscript.SegmentTranscript.StructuredSegment
Api Reference
FoundationModelsGenerationIDSystemLanguageModelSystemLanguageModel.AdapterSystemLanguageModel.GuardrailsSystemLanguageModel.UseCase
Getting Started
SystemLanguageModel.Availability
Guided Generation
DynamicGenerationSchemaGenerableGenerationGuideGenerationSchemaGuide
Localization
LanguageModelFeedback
Prompting
InstructionsInstructionsBuilderInstructionsRepresentableLanguageModelSessionLanguageModelSession.GenerationErrorLanguageModelSession.ToolCallErrorPromptPromptBuilderPromptRepresentableTranscript.InstructionsTranscript.Prompt
Tool Calling
Tool
Key Concepts
Platform Support
- iOS 26.0+
- iPadOS 26.0+
- macOS 26.0+
- Mac Catalyst 26.0+
- visionOS 26.0+
On-Device AI
All models run entirely on-device, ensuring privacy and offline capability.
Usage Guidelines
- Check model availability before use
- Define clear instructions for the model's behavior
- Use guided generation for structured outputs
- Implement tool calling for dynamic capabilities
- Handle errors appropriately
Navigation
See the references/ directory for detailed API documentation organized by category:
references/advanced.md- Advancedreferences/api_reference.md- Api Referencereferences/getting_started.md- Getting Startedreferences/guided_generation.md- Guided Generationreferences/localization.md- Localizationreferences/prompting.md- Promptingreferences/tool_calling.md- Tool Calling
Best Practices
- Prompting: Be specific and clear in your prompts
- Instructions: Define the model's behavior upfront
- Safety: Enable guardrails for sensitive content
- Localization: Check supported languages for your use case
- Performance: Use prewarm() for better response times
- Streaming: Use streamResponse() for real-time user feedback
Common Patterns
Basic Session
let model = SystemLanguageModel(useCase: .general)
let session = LanguageModelSession(model: model)
let response = try await session.respond(to: Prompt("Your question"))
Guided Generation
struct Recipe: Generable {
let title: String
let ingredients: [String]
}
let recipe = try await session.respond(
generating: Recipe.self,
prompt: Prompt("Create a pasta recipe")
)
Tool Calling
struct WeatherTool: Tool {
func call(arguments: String) async throws -> String {
// Fetch weather data
}
}
let session = LanguageModelSession(
model: model,
tools: [WeatherTool()]
)
Reference Documentation
For complete API details, see the categorized documentation in the references/ directory.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/ios-agent/iosagent.dev/apple-foundation-models">View apple-foundation-models on skillZs</a>