swift-ios-skills

Swift iOS Skills — Agent Skills for iOS 26+ & SwiftUI Development

86 agent skills optimized for iOS 26+ development with Swift 6.3 and modern Apple frameworks. All code examples, patterns, and guidance target the latest APIs -- Liquid Glass, approachable concurrency, Foundation Models, StoreKit 2, SwiftData, async/await URLSession, and more. No deprecated patterns.

Compatible with Claude Code, OpenAI Codex, Cursor, GitHub Copilot, and 40+ other agents. Follows the open Agent Skills standard.

Every skill is self-contained. No skill depends on another. Install only what you need.

Release history: CHANGELOG.md.

Contents

• Install
  • Recommended: any agent via skills CLI
  • Claude Code
  • OpenAI Codex
  • Claude Web App / Claude Desktop
  • ChatGPT
• Plugin Bundles
• Skills
  • SwiftUI
  • Core Swift
  • App Experience Frameworks
  • Data & Service Frameworks
  • AI & Machine Learning
  • iOS Engineering
  • Hardware & Device Integration
  • Platform Integration
  • Gaming
• Structure
• Compatibility
• Upgrading from v2.x
• Support
• License

Install

Recommended: any agent via skills CLI

The skills CLI is the recommended install method.

Interactive install (recommended):

npx skills add dpearson2699/swift-ios-skills

Running the default command opens the skills CLI UI so you can choose which skills to install and which agent(s) to install them for.

Install everything for any coding agent:

npx skills add dpearson2699/swift-ios-skills --all

Use --all when you want the full set of 86 skills installed automatically for any coding agent.

Install specific skills directly:

npx skills add dpearson2699/swift-ios-skills --skill <skill-name> --skill <skill-name>

Check for updates to installed skills:

npx skills check

Update installed skills to the latest versions:

npx skills update

Use these after installing through the skills CLI.

Claude Code (via plugin marketplace)

Add the marketplace (one-time):

/plugin marketplace add dpearson2699/swift-ios-skills

Install everything:

/plugin install all-ios-skills@swift-ios-skills

Or install a themed bundle (bundles limit how many skills load into the context window — if you want everything, use all-ios-skills above instead of installing multiple bundles):

/plugin install swiftui-skills@swift-ios-skills
/plugin install swift-core-skills@swift-ios-skills
/plugin install ios-app-framework-skills@swift-ios-skills
/plugin install ios-data-framework-skills@swift-ios-skills
/plugin install ios-ai-ml-skills@swift-ios-skills
/plugin install ios-engineering-skills@swift-ios-skills
/plugin install ios-hardware-skills@swift-ios-skills
/plugin install ios-platform-skills@swift-ios-skills
/plugin install ios-gaming-skills@swift-ios-skills
/plugin install apple-kit-skills@swift-ios-skills

OpenAI Codex

$skill-installer install https://github.com/dpearson2699/swift-ios-skills/tree/main/skills/<skill-name>

Claude Web App / Claude Desktop

1. Download the skill folder(s) you want from this repo
2. Zip each skill folder
3. Go to Settings > Capabilities and enable "Code execution and file creation"
4. Go to Customize > Skills, click +, then Upload a skill
5. Upload the zip

ChatGPT

1. Download the skill folder(s) you want from this repo
2. Zip each skill folder
3. Click your profile icon in ChatGPT and select Skills
4. Click New skill and select Upload from your computer
5. Upload the zip

Plugin Bundles (Claude Code)

Plugin	Skills included
all-ios-skills	All 86 skills
apple-kit-skills	39 skills spanning Apple Kit frameworks plus CarPlay
swiftui-skills	focus-engine, swiftui-animation, swiftui-gestures, swiftui-layout-components, swiftui-liquid-glass, swiftui-navigation, swiftui-patterns, swiftui-performance, swiftui-uikit-interop, swiftui-webkit
swift-core-skills	core-data, swift-api-design-guidelines, swift-architecture, swift-codable, swift-charts, swift-concurrency, swift-formatstyle, swift-language, swift-testing, swiftdata
ios-app-framework-skills	activitykit, adattributionkit, alarmkit, app-clips, app-intents, avkit, carplay, mapkit, paperkit, pdfkit, photokit, push-notifications, storekit, tipkit, widgetkit
ios-data-framework-skills	cloudkit, contacts-framework, eventkit, financekit, healthkit, musickit, passkit, weatherkit
ios-ai-ml-skills	apple-on-device-ai, coreml, natural-language, speech-recognition, vision-framework
ios-engineering-skills	app-store-optimization, app-store-review, authentication, background-processing, cryptokit, debugging-instruments, device-integrity, ios-accessibility, ios-ettrace-performance, ios-localization, ios-memgraph-analysis, ios-networking, swift-security, swiftlint, ios-simulator, metrickit
ios-hardware-skills	accessorysetupkit, core-bluetooth, core-motion, core-nfc, dockkit, pencilkit, realitykit, sensorkit
ios-platform-skills	appmigrationkit, audioaccessorykit, browserenginekit, callkit, cryptotokenkit, energykit, homekit, permissionkit, relevancekit, shareplay-activities
ios-gaming-skills	gamekit, scenekit, spritekit, tabletopkit

Skills

SwiftUI

Skill	What it covers
focus-engine	@FocusState, defaultFocus, focusSection, focused scene values, focus restoration, UIFocusGuide
swiftui-animation	Spring animations, PhaseAnimator, KeyframeAnimator, matchedGeometryEffect, SF Symbols
swiftui-gestures	Tap, drag, magnify, rotate, long press, simultaneous and sequential gestures
swiftui-layout-components	Grid, LazyVGrid, Layout protocol, ViewThatFits, custom layouts
swiftui-liquid-glass	iOS 26 Liquid Glass, glassEffect, GlassEffectContainer, morphing transitions
swiftui-navigation	NavigationStack, NavigationSplitView, programmatic navigation, deep linking
swiftui-patterns	@Observable, state ownership, environment wiring, view composition, async loading, MV-pattern architecture
swiftui-performance	Rendering performance, view update optimization, layout thrash, Instruments profiling
swiftui-uikit-interop	UIViewRepresentable, UIHostingController, Coordinator, incremental UIKit-to-SwiftUI migration
swiftui-webkit	WebView, WebPage, navigation policies, JavaScript calls, local content, custom URL schemes

Core Swift

Skill	What it covers
swift-api-design-guidelines	Swift API Design Guidelines -- argument labels, mutating/nonmutating pairs, documentation comments, naming conventions
swift-architecture	Architecture patterns: MV (@Observable), MVVM, MVI, TCA, Clean Architecture, Coordinator, decision framework
swift-codable	Swift Codable, JSONDecoder, JSONEncoder, CodingKeys, custom decoding, nested JSON
swift-charts	Bar, line, area, pie, donut, and 3D charts, scrolling, selection, annotations
swift-concurrency	Swift 6.2 concurrency, Sendable, actors, structured concurrency, data-race safety
swift-formatstyle	FormatStyle protocol, number/currency/date/duration/measurement formatting, custom styles
swift-language	Swift 6.3 language idioms, result builders, property wrappers, typed throws
swift-testing	Swift Testing framework, @Test, @Suite, #expect, parameterized tests, mocking
core-data	Core Data persistence, NSPersistentContainer, NSFetchedResultsController, batch operations, staged migration
swiftdata	@Model, @Query, #Predicate, ModelContainer, migrations, CloudKit sync, @ModelActor

App Experience Frameworks

Skill	What it covers
activitykit	ActivityKit, Dynamic Island, Lock Screen Live Activities, push-to-update
adattributionkit	Privacy-preserving ad attribution, postbacks, conversion values, re-engagement
alarmkit	AlarmKit system alarms and countdown timers, Lock Screen, Dynamic Island, Live Activities
app-clips	App Clips, invocation URLs, NFC, QR, App Clip Codes, App Group handoff
app-intents	App Intents for Siri, Shortcuts, Spotlight, widgets, and Apple Intelligence
avkit	AVPlayerViewController, VideoPlayer, Picture-in-Picture, AirPlay, subtitles
carplay	CarPlay templates, navigation, audio, communication, EV charging apps
mapkit	MapKit, CoreLocation, annotations, geocoding, directions, geofencing
paperkit	PaperMarkupViewController, markup editing, drawing, shapes (iOS 26)
pdfkit	PDFView, PDFDocument, annotations, text search, form filling, thumbnails
photokit	PhotosPicker, AVCaptureSession, photo library, video recording, media permissions
push-notifications	UNUserNotificationCenter, APNs, rich notifications, silent push, service extensions
storekit	StoreKit 2 purchases, subscriptions, SubscriptionStoreView, transaction verification
tipkit	Feature discovery tooltips, contextual tips, tip rules, tip events
widgetkit	Home Screen, Lock Screen, and StandBy widgets, Control Center controls, timeline providers

Data & Service Frameworks

Skill	What it covers
cloudkit	CKContainer, CKRecord, subscriptions, sharing, CKSyncEngine, SwiftData sync
contacts-framework	CNContactStore, fetch requests, key descriptors, CNContactPickerViewController, save requests
eventkit	EKEventStore, EKEvent, EKReminder, recurrence rules, EventKitUI editors and choosers
financekit	Apple Card, Apple Cash, Wallet orders, transaction queries, account balances
healthkit	HKHealthStore, queries, statistics, workout sessions, background delivery
musickit	MusicKit authorization, catalog search, ApplicationMusicPlayer, MPRemoteCommandCenter
passkit	Apple Pay, PKPaymentRequest, PKPaymentAuthorizationController, Wallet passes
weatherkit	WeatherService, current/hourly/daily forecasts, alerts, attribution requirements

AI & Machine Learning

Skill	What it covers
apple-on-device-ai	Foundation Models framework, Core ML, MLX Swift, on-device LLM inference
coreml	Core ML model loading, prediction, MLTensor, compute unit configuration, VNCoreMLRequest, MLComputePlan
natural-language	NLTokenizer, NLTagger, sentiment analysis, language identification, embeddings, Translation
speech-recognition	SpeechAnalyzer, SpeechTranscriber, SFSpeechRecognizer, on-device recognition, audio buffer processing
vision-framework	Vision text recognition, face/barcode detection, image segmentation, VisionKit DataScannerViewController

iOS Engineering

Skill	What it covers
app-store-optimization	ASO keyword strategy, description writing, screenshot optimization, Custom Product Pages, A/B testing
app-store-review	App Review guidelines, rejection prevention, privacy manifests, ATT, HIG compliance
authentication	Sign in with Apple, ASAuthorizationController, passkeys, biometric auth (LAContext), credential management
background-processing	BGTaskScheduler, background refresh, URLSession background transfers
cryptokit	SHA-2/SHA-3, HMAC, AES-GCM, ChaChaPoly, HPKE, ML-KEM/ML-DSA, P256/Curve25519 signing, ECDH, Secure Enclave
debugging-instruments	Xcode debugger, Instruments, os_signpost, MetricKit, crash symbolication
device-integrity	DeviceCheck (DCDevice per-device bits), App Attest (DCAppAttestService attestation and assertion flows)
ios-accessibility	VoiceOver, Dynamic Type, custom rotors, accessibility focus, assistive-technology support
ios-ettrace-performance	ETTrace launch/runtime capture, exact-build dSYM matching, processed flamegraph JSON, comparable verification
ios-localization	String Catalogs, pluralization, FormatStyle, right-to-left layout
ios-memgraph-analysis	Simulator memgraph capture, leak ownership paths, reachable heap growth, raw evidence preservation
ios-networking	URLSession async/await, REST APIs, downloads/uploads, WebSockets, pagination, retry, caching
swift-security	Keychain Services, CryptoKit symmetric/asymmetric, biometric authentication, Secure Enclave, certificate trust, credential storage, OWASP compliance · Based on ivan-magda/swift-security-skill
ios-simulator	xcrun simctl commands, device lifecycle, push/location/privacy simulation, log streaming, simulator limitations
metrickit	MetricManager async reports, hang/crash diagnostics, production performance telemetry
swiftlint	SwiftLint setup, .swiftlint.yml, build tool plugin, rule selection, baselines, suppressions, CI integration

Hardware & Device Integration

Skill	What it covers
accessorysetupkit	Privacy-preserving BLE/Wi-Fi accessory discovery, ASAccessorySession, picker UI
core-bluetooth	CBCentralManager, CBPeripheral, BLE scanning/connecting, services, characteristics, background modes
core-motion	CMMotionManager, CMPedometer, accelerometer, gyroscope, activity recognition, altitude
core-nfc	NFCNDEFReaderSession, NFCTagReaderSession, NDEF reading/writing, background tag reading
dockkit	DockAccessoryManager, camera subject tracking, motor control, framing
pencilkit	PKCanvasView, PKDrawing, PKToolPicker, Apple Pencil drawing and annotation
realitykit	RealityView, entities, anchors, ARKit world tracking, raycasting, scene understanding
sensorkit	Research-grade sensor data, ambient light, keyboard metrics, device usage (approved studies)

Platform Integration

Skill	What it covers
appmigrationkit	Cross-platform data transfer, AppMigrationExtension export/import (iOS 26)
audioaccessorykit	Audio accessory features, automatic switching, device placement (iOS 26.4)
browserenginekit	Alternative browser engines (EU), process management, web content extensions
callkit	CXProvider, CXCallController, PushKit VoIP registration, call directory extensions
cryptotokenkit	TKTokenDriver, TKSmartCard, iOS 26 NFC smart cards, certificate-based auth
energykit	ElectricityGuidance, EnergyVenue, grid forecasts, load event submission, electricity insights
homekit	HMHomeManager, accessories, rooms, actions, triggers, MatterSupport commissioning
permissionkit	AskCenter, PermissionQuestion, child communication safety, CommunicationLimits
relevancekit	Widget relevance signals, time/location-based relevance providers (watchOS 26)
shareplay-activities	GroupActivity, GroupSession, GroupSessionMessenger, coordinated media playback

Gaming

Skill	What it covers
gamekit	Game Center, GKLocalPlayer, leaderboards, achievements, real-time and turn-based multiplayer
scenekit	SCNView, SCNScene, 3D geometry, materials, lighting, physics, SceneView
spritekit	SKScene, SKSpriteNode, SKAction, physics simulation, particle effects, SpriteView
tabletopkit	Multiplayer spatial board games, pieces, cards, dice, Group Activities (visionOS)

Structure

Each skill follows the open Agent Skills standard:

skills/
  skill-name/
    SKILL.md              # Required — instructions and metadata
    references/           # Optional — detailed reference material
      some-topic.md

SKILL.md contains YAML frontmatter (name, description) and markdown instructions. The references/ folder holds longer examples, advanced patterns, and lookup tables that the main file points to.

This repository contains original instructional content and examples for Apple platform development. Where Apple frameworks, APIs, documentation, WWDC sessions, or trademarks are referenced, those materials remain the property of Apple Inc. The license for this repository applies to this project's original content only and does not claim ownership of or relicense Apple's documentation, trademarks, sample code, or other third-party materials.

Compatibility

These skills work with any agent that supports the Agent Skills standard, including:

• Claude Code (Anthropic)
• OpenAI Codex
• Cursor
• GitHub Copilot
• Windsurf
• Roo Code
• And many more

Upgrading from v2.x

v3.0 is a major release. If you previously installed v2.x skills, note the following changes:

• Skill count: 57 skills in v2.2.0, 76 skills in v3.0.0.

• Skill renames: 12 existing skills renamed to use Apple Kit framework names. Old skill paths no longer resolve. Uninstall all skills and reinstall to upgrade.

  v2.x name	v3.0 name
  live-activities	activitykit
  mapkit-location	mapkit
  photos-camera-media	photokit
  homekit-matter	homekit
  callkit-voip	callkit
  metrickit-diagnostics	metrickit
  pencilkit-drawing	pencilkit
  passkit-wallet	passkit
  musickit-audio	musickit
  cloudkit-sync	cloudkit
  eventkit-calendar	eventkit
  realitykit-ar	realitykit

• 19 new Kit framework skills: avkit, gamekit, cryptokit, pdfkit, paperkit, spritekit, scenekit, financekit, accessorysetupkit, adattributionkit, carplay, appmigrationkit, browserenginekit, dockkit, sensorkit, tabletopkit, relevancekit, audioaccessorykit, cryptotokenkit.

• New bundles: apple-kit-skills (all 39 Apple Kit framework skills) and ios-gaming-skills (GameKit, SpriteKit, SceneKit, TabletopKit).

• PaperKit standalone: PaperKit content removed from pencilkit and is now its own paperkit skill.

• Beta frameworks: permissionkit, energykit, paperkit, relevancekit, appmigrationkit, and audioaccessorykit require iOS/watchOS 26 beta and are subject to API changes before GM.

• All skills remain self-contained: No skill references or depends on another.

To upgrade via the skills CLI:

npx skills add dpearson2699/swift-ios-skills

To upgrade Claude Code bundles, reinstall the bundles you use (old skill paths will no longer resolve).

Support

If these skills save you time or improve your workflow, you can support ongoing maintenance through GitHub Sponsors.

Support helps keep the collection current with new Apple releases, evolving framework APIs, updated examples, and compatibility work across Claude Code, Codex, Cursor, Copilot, and other agents.

Sponsors

Thanks to the following people for supporting this project:

License

PolyForm Perimeter 1.0.0 -- see LICENSE

What this means in practice:

• Using these skills to build your iOS app -- allowed
• Using these skills inside a closed-source commercial workflow -- allowed
• Forking the repo and contributing back -- allowed
• Sharing the skills with a teammate -- allowed
• Taking the skills, rebranding them as "Premium iOS Agent Skills," and selling them -- not allowed (that's a competing product)

This project is not affiliated with, endorsed by, or sponsored by Apple Inc.