Expert Apple platform development guidance for any AI coding tool that supports the Agent Skills open format — UIKit patterns, Xcode/Tuist project setup, and Swift coding conventions for app development.
- Teams building or maintaining UIKit-based iOS/iPadOS apps
- Developers setting up Xcode projects with Tuist, XcodeGen, or pure Xcode
- Anyone reviewing Swift code in an Apple app context
npx skills add https://github.com/ohlulu/Apple-Dev-Skill --skill apple-dev-skillpi install https://github.com/ohlulu/Apple-Dev-Skill- Clone this repository
- Install or symlink
apple-dev-skill/following your tool's skills installation docs
Three domains unified under a single Topic Router. Reference files load on demand, so your agent gets deep guidance only for the topic at hand.
| Reference | Coverage |
|---|---|
| file-structure | Property ordering, extensions, layout placement for VC / View / Cell |
| animation | Duration, curve, fade defaults, stagger reveal |
| list-composition | Row/item controllers, section controllers, load-more, pagination, diffable, compositional layout |
| composer | Programmatic controller instantiation, dependency wiring, navigation closures |
| testing-principles | Test levels, async spies, assertion strategy, memory leak tracking |
| testing | UIKit lifecycle simulation, semantic list helpers, pagination integration tests |
| uiview-representable | SwiftUI bridging — diff-based updates, coordinator callbacks, pre-rendered bitmaps |
| (24 reference files total) |
| Reference | Coverage |
|---|---|
| xcode-project-setup | Workspace layout, synced folders, SPM deps, app identity, shared schemes, gotchas |
| xcconfig | Hierarchy, naming, inline vs file, Xcode upgrade SOP |
| build-phases | SwiftFormat hook, SwiftLint, Firebase Crashlytics, sandboxing |
| makefile | Design principles, simulator destination, run target |
| tuist-spm-integration | Native vs XcodeProj-based, migration steps |
| xcodebuild-error-detection | Dual failure detection pattern |
| Reference | Coverage |
|---|---|
| swift-style | Type design, protocols, error handling, API design, file organization |
Non-opinionated: focuses on correctness and practical patterns, not architecture or code style enforcement.
apple-dev-skill/
SKILL.md
references/
alignment.md
animation.md
associated-objects.md
autolayout-spacing.md
build-phases.md
cell-registration.md
composer.md
compound-cell-row-animation.md
file-structure.md
icloud-ubiquity.md
image-resizing.md
keyboard-avoidance.md
list-composition.md
Makefile.template
makefile.md
menu-vs-popover.md
navigation-bar-appearance.md
overflow-detection.md
popover-tooltip.md
self-sizing.md
shadow-and-clipping.md
swift-style.md
testing-principles.md
testing.md
tuist-spm-integration.md
uibutton-configuration.md
uibutton-icon-badge.md
uiview-representable.md
view-wrapping.md
xcconfig.md
xcode-project-setup.md
xcodebuild-error-detection.md
This skill was previously named uikit-expert-skill. It now also includes content from xcode-skill and swift-coding-style. If you had the old skill installed, uninstall it and install this one.
Contributions welcome — fix incorrect guidance, add modern APIs, expand reference coverage. Keep content focused on Apple app development.
MIT License. See LICENSE for details.