Apple development skills for Claude Code and Codex — latest iOS 26+ APIs, SwiftUI, Liquid Glass, and more.
These are coding agent skills (reference docs + guidelines) that help AI assistants write production-grade iOS/macOS Swift code using current Apple APIs.
All reference documentation is downloaded verbatim from sosumi.ai, which mirrors Apple's developer.apple.com as clean, LLM-friendly markdown.
# Dry run — see what changed since last download
./scripts/refresh-docs.sh
# Apply updates
./scripts/refresh-docs.sh --apply
# Commit the changes
git add -A && git commit -m "docs: refresh from sosumi.ai $(date +%Y-%m-%d)"The script finds all .md files with a source: https://developer.apple.com/... header, re-downloads them from sosumi.ai, and diffs against the local copy. Only files with actual content changes (ignoring timestamp differences) are flagged.
To download a new Apple documentation page:
# Single topic
curl -sL "https://sosumi.ai/documentation/swiftui/navigationstack" > skills/swiftui/navigationstack.md
# Framework index
curl -sL "https://sosumi.ai/documentation/storekit" > skills/storekit/storekit-index.md
# HIG pages use a different path pattern
curl -sL "https://sosumi.ai/design/human-interface-guidelines/buttons" > skills/hig/buttons.md2026-02-19 — 50 files updated, 89 unchanged, 1 failed (navigation-bars HIG page moved).
| Skill | Files | Description |
|---|---|---|
| swiftui | 50 | SwiftUI views, modifiers, navigation, state management, charts |
| swift-testing | 8 | Swift Testing framework (@Test, @Suite, #expect, #require) |
| swift-concurrency | 8 | async/await, Task, TaskGroup, Actor, AsyncSequence |
| swiftdata | — | @Model, ModelContext, @Query, schema migrations |
| healthkit | — | HKHealthStore, HKQuantitySample, workouts, health data |
| combine | — | Publishers, subscribers, operators |
| storekit | 7 | StoreKit 2 (Product, Transaction, SubscriptionStoreView) |
| mapkit | 8 | MapKit for SwiftUI (Map, Marker, Annotation, MapCameraPosition) |
| tipkit | 7 | TipKit (Tip protocol, TipView, PopoverTipView) |
| appintents | — | App Intents, Siri, Shortcuts, Spotlight integration |
| widgetkit | — | Widget timelines, entries, providers |
| usernotifications | — | Local/remote notifications, triggers |
| eventkit | — | EKEventStore, EKEvent, EKReminder, calendar access |
| photosui | — | PhotosPicker, photo selection |
| corehaptics | — | CHHapticEngine, haptic patterns |
| backgroundtasks | — | BGTaskScheduler, app refresh |
| xcuitest | 10 | XCUITest with Swift 6 @MainActor patterns |
| Skill | Files | Description |
|---|---|---|
| hig | 41 | Apple Human Interface Guidelines |
| ios-liquid-glass | 17 | Liquid Glass API reference (iOS 26+) |
| ios-design-consultant | — | UX/design guidance for Liquid Glass apps |
| ios-dev | — | SwiftUI development patterns & aesthetics |
These are expert workflow/pattern guides — they teach how to approach tasks (audit performance, refactor views, build apps), as opposed to the reference docs above which document what APIs exist. Originally from Dimillian/Skills by Thomas Ricouard. MIT License.
| Skill | Files | Description |
|---|---|---|
| guide-swiftui-performance-audit | 5 | Audit and improve SwiftUI runtime performance from code review and architecture |
| guide-swiftui-ui-patterns | 27 | Best practices and examples for building SwiftUI views and components |
| guide-swiftui-view-refactor | 2 | Refactor SwiftUI views for consistent structure and Observation usage |
| guide-macos-spm-packaging | 16 | Scaffold, build, and package SwiftPM-based macOS apps without Xcode |
| Skill | Description |
|---|---|
| apple-docs-index | Index of Apple developer documentation — start here to find what you need |
| simulator-utils | iOS Simulator commands, screenshots, device management |
| apple-aso | App Store Optimization for metadata |
| ios-app-icon | App icon generation workflow |
| ios-app-assets | In-app asset generation workflow |
iOS 26+ / Swift 6 — no legacy patterns. Uses:
@Observablemacro (notObservableObject)NavigationStack(notNavigationView)- Swift concurrency (
async/await, not completion handlers) - Liquid Glass design system
- Swift Testing where applicable
All .md reference files (everything except SKILL.md) are verbatim downloads from sosumi.ai. Each file has a YAML frontmatter header with:
---
title: Button
description: A control that initiates an action.
source: https://developer.apple.com/documentation/swiftui/button
timestamp: 2026-02-19T07:52:54.922Z
---source— the original Apple developer docs URLtimestamp— when the file was downloaded from sosumi.ai
The SKILL.md files are hand-written skill descriptions and are the only non-verbatim content.
# Add as a Claude Code plugin
claude plugins add vabole/apple-skillsReference skills in your Codex global config or project AGENTS.md.
git clone https://github.com/vabole/apple-skills.gitEach skill has a SKILL.md with metadata and instructions, plus reference .md files with API documentation.
skills/ # 30 skills (26 reference + 4 guides)
├── swiftui/ # 50 SwiftUI reference files
├── hig/ # 41 HIG reference files
├── ios-liquid-glass/ # 17 Liquid Glass API docs
├── swift-testing/ # Swift Testing framework
├── swift-concurrency/ # async/await, actors
├── storekit/ # StoreKit 2
├── mapkit/ # MapKit for SwiftUI
├── tipkit/ # TipKit framework
├── healthkit/ # HealthKit API docs
├── ... # and more
├── apple-docs-index/ # Framework doc indexes
├── guide-swiftui-performance-audit/ # Performance audit guide
├── guide-swiftui-ui-patterns/ # UI patterns guide (26 references)
├── guide-swiftui-view-refactor/ # View refactoring guide
└── guide-macos-spm-packaging/ # macOS SPM packaging guide
scripts/
└── refresh-docs.sh # Re-download all docs from sosumi.ai
MIT
