Apple Foundation Models Skill – README

Overview

This repository contains comprehensive reference documentation and guidance for Apple’s Foundation Models framework on iOS 26+ and macOS 26+. It serves as a complete skill guide for developers building on-device AI capabilities using Apple’s on-device language models.

The goal of this project is to provide clear, organized documentation on how to:

• Integrate Apple’s on-device language models using the FoundationModels framework
• Build and configure skills that leverage SystemLanguageModel for on-device inference
• Implement advanced patterns including guided generation, tool calling, and streaming responses
• Handle safety, localization, and performance considerations for on-device AI

The Skill Covers

• On-device LLM integration using the FoundationModels framework
• SystemLanguageModel – Apple’s on-device language model API
• LanguageModelSession – Managing conversations and model interactions
• Guided Generation – Generating structured Swift types from prompts
• Tool Calling – Extending model capabilities with custom tools and integrations
• Prompting – Crafting effective prompts and system instructions
• Safety – Implementing guardrails and handling sensitive content
• Localization – Supporting multilingual AI features
• Performance – Optimization patterns and best practices

Requirements

• Xcode 17 or later with Foundation Models support
• iOS 26, iPadOS 26, macOS 26, or visionOS 26 (or later)
• Swift and SwiftUI basic knowledge (for implementation)
• Device or simulator that supports Apple Intelligence and the Foundation Models framework

Installation

Install as a Claude Code Skill

This skill is available in the Claude Code marketplace. To install it:

/plugin marketplace add Eyadkelleh/apple_foundation_models_claude_skill

Then install the skill:

/plugin install apple-foundation-models@apple-foundation-models-marketplace

Once installed, Claude Code will automatically suggest this skill when you’re working with Apple Foundation Models.

Getting Started

1. Clone the Repository

git clone https://github.com/Eyadkelleh/apple_foundation_models_claude_skill.git
cd apple_foundation_models_claude_skill

2. Explore the Documentation

The repository is organized into focused reference guides:

• Getting Started – Initial setup and basic patterns
• Prompting – How to craft effective prompts and instructions
• Guided Generation – Generating structured outputs
• Tool Calling – Extending models with custom tools
• Safety – Guardrails and safety considerations
• Localization – Multilingual support
• API Reference – Complete API documentation