v3.4.0

New skills

• swiftlint — SwiftLint setup and enforcement: build tool plugin via SimplyDanny/SwiftLintPlugins, .swiftlint.yml configuration, rule selection strategy, disabled_rules/opt_in_rules/only_rules, baselines for incremental adoption, inline suppressions, autocorrect, CI integration with SARIF/GitHub Actions reporters, multiple configurations, regex custom rules, swiftlint analyze, multi-toolchain guidance

Bundle changes

• Add swiftlint to ios-engineering-skills and all-ios-skills bundles.
• Update all-ios-skills count from 83 to 84.
• Update ios-engineering-skills description and keywords to include linting coverage.

Repository

• Update README catalog, bundle table, install count, and skill listings for new skill.

What's New

83 skills (up from 79)

New skills

• core-data — Core Data persistence: NSPersistentContainer stack setup, NSFetchedResultsController, batch operations, persistent history tracking, staged migration (iOS 17+), composite attributes, testing patterns
• swift-architecture — Architecture pattern selection: MV (@Observable), MVVM, MVI, TCA, Clean Architecture, Coordinator pattern, decision framework, migration guidance
• swift-formatstyle — FormatStyle protocol and all concrete types: numbers, currency, percentages, dates, durations, measurements, person names, lists, byte counts, URLs, custom FormatStyle
• focus-engine — SwiftUI and UIKit focus behavior including @FocusState, defaultFocus, focusedSceneValue, focusSection(), focus restoration, and UIFocusGuide

Skill updates

• focus-engine — Expand description to cover tvOS, watchOS, visionOS, macOS. Add multi-platform-focus.md (tvOS geometric model, watchOS Digital Crown, visionOS gaze/hover, macOS key view loop) and focus-debugging.md (UIFocusDebugger LLDB commands, anti-patterns)
• ios-accessibility — Add AppKit accessibility coverage for NSAccessibilityProtocol, NSAccessibilityElement, and AppKit accessibility notifications. Add nutrition-labels.md (all 9 App Store Accessibility Nutrition Labels) and media-accessibility.md (captions, audio descriptions, SDH)
• swift-testing — Add execution-model guidance for parallel execution, shared-state hazards, .serialized scope semantics. Add CustomTestStringConvertible and @available-conditional test patterns
• swift-concurrency — Add bridging-interop.md (checked continuations, delegate bridging, GCD migration), diagnostics.md (compiler diagnostic → fix reference), async-algorithms.md (debounce, throttle, merge, combineLatest, chunks)
• swiftdata — Add predicate-pitfalls.md (#Predicate runtime crashes) and indexing.md (#Index macro iOS 18+, compound indexes)
• swiftui-performance — Add ternary-modifier pattern for preserving structural identity (avoid _ConditionalContent when toggling modifiers)
• swiftui-patterns — Replace custom environment example with modern @Entry guidance. Update haptics to prefer sensoryFeedback(_:trigger:). Expand deprecated-migration.md with cornerRadius → clipShape, tabItem → Tab (iOS 18+), scrollIndicators(.hidden)

Bundle changes

• Add focus-engine to swiftui-skills and all-ios-skills bundles
• Add core-data, swift-architecture, swift-formatstyle to swift-core-skills and all-ios-skills bundles
• Update all-ios-skills count from 79 to 83

Repository

• Add AGENTS.md with repo-level agent instructions for skill authoring
• Fix executable permission on CI sync-skill-dropdowns.sh script

What's New

79 skills (up from 76)

New skills

• app-store-optimization — ASO keyword strategy, title/subtitle optimization, description writing, screenshot captions, Custom Product Pages, in-app events, product page A/B testing
• ios-simulator — xcrun simctl device lifecycle, push/location/permission simulation, log streaming, status bar overrides, screenshot/video capture, simulator limitations
• swift-api-design-guidelines — argument labels, mutating/nonmutating pairs, side-effect naming, documentation comments, O(1) complexity rule, Swift naming conventions

Replaced

• ios-security → swift-security — vendored from ivan-magda/swift-security-skill. Deeper coverage of Keychain, CryptoKit, biometrics, Secure Enclave, and OWASP compliance (14 reference files). Migrated ATS and file storage content to ios-networking.

Skill updates

• ios-localization — Generated Localizable Symbols (Xcode 26+), stable key naming guidance, extraction state documentation
• swiftui-patterns — "When a New ViewModel Is Justified", "Environment vs. Initializer Injection", modern @Observable ViewModel with @Bindable child, foregroundColor→foregroundStyle migration, @AppStorage in @Observable warning, adaptive spacing guidance
• swiftui-gestures — Common Mistake: onTapGesture for actions that should use Button
• swiftui-layout-components — ScrollPosition replaces ScrollViewReader patterns, adaptive spacing rule, .onGeometryChange availability corrected to iOS 16+
• swiftui-animation — onTapGesture→Button in keyframe and matchedGeometryEffect examples
• widgetkit — Design Patterns section: Gauge for value indicators, containerBackground, Canvas for dense visualizations, timeline refresh guidance. Simplified widget families table and Live Activity example
• ios-networking — App Transport Security (ATS) section, file-storage-patterns reference migrated from ios-security
• device-integrity, energykit — Fixed Task.sleep retry logic (guard final-attempt sleep, modern Task.sleep(for:) API)

Code example improvements

• Removed ~50 unnecessary hard-coded spacing: and .padding(.direction, N) values across 34 skill files — examples now model the best practice of omitting spacing for adaptive platform defaults
• Replaced onTapGesture with Button + .buttonStyle(.plain) for single-tap actions across natural-language, swiftui-animation, core-animation-bridge, and deprecated-migration examples
• Modernized .clipShape(RoundedRectangle(cornerRadius:)) to .clipShape(.rect(cornerRadius:)) shorthand

Bundle changes

• Added app-store-optimization, ios-simulator, swift-api-design-guidelines to their respective bundles
• Replaced ios-security with swift-security in ios-engineering-skills and all-ios-skills
• Updated all-ios-skills count from 76 to 79

v3.1.0 — Swift 6.3 Update

All 76 skills updated to target Swift 6.3.

New feature coverage

Language (swift-language):

• @c attribute for C-calling-convention export (SE-0495)
• @specialized for generic specialization (SE-0460)
• @inline(always) guarantee (SE-0496)
• @export(interface) / @export(implementation) for symbol visibility (SE-0497)
• @section / @used for binary section control (SE-0492)
• ModuleName::symbol module selectors (SE-0491)

Concurrency (swift-concurrency):

• async defer blocks (SE-0493)
• Clock epochs for ContinuousClock and SuspendingClock (SE-0473)

Testing (swift-testing):

• Warning-severity issues — Issue.record("msg", severity: .warning) (ST-0013)
• Programmatic test cancellation — try Test.cancel() (ST-0016)
• Exit test value capturing (ST-0012)
• Image attachments via cross-import overlays (ST-0014)

Structural improvements

• Swift 6.3 features integrated into existing topical sections (no version-siloed ## Swift 6.3 Additions sections)
• Version-based reference files renamed to topic-based names
• Marketplace bundle versions bumped to 3.1.0

Install

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

See CHANGELOG.md for full details.

v3.0.0

76 agent skills for iOS 26+ development with Swift 6.2 and modern Apple frameworks.

Highlights

• 19 new skills: AVKit, GameKit, CryptoKit, PDFKit, PaperKit, SpriteKit, SceneKit, FinanceKit, AccessorySetupKit, AdAttributionKit, CarPlay, AppMigrationKit, BrowserEngineKit, DockKit, SensorKit, TabletopKit, RelevanceKit, AudioAccessoryKit, CryptoTokenKit.
• 12 skill renames to use Apple Kit framework names (e.g., live-activities → activitykit, mapkit-location → mapkit).
• 2 new bundles: apple-kit-skills (39 Apple Kit frameworks) and ios-gaming-skills (GameKit, SpriteKit, SceneKit, TabletopKit).
• PaperKit standalone: PaperKit content removed from pencilkit and is now its own paperkit skill.
• Full audit pass: 15+ incorrect deprecation claims fixed, all Sosumi links normalized, reference files expanded, scope statements added, all skills verified against Apple documentation.

Install

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

Or via Claude Code plugin marketplace:

/plugin marketplace add dpearson2699/swift-ios-skills
/plugin install all-ios-skills@swift-ios-skills

See CHANGELOG.md for full details.

Highlights

• Add swiftui-webkit, a new SwiftUI skill for native WebKit-for-SwiftUI APIs including WebView, WebPage, navigation policies, JavaScript calls, observable page state, and custom URL schemes.
• Narrow swiftui-uikit-interop back to generic interop guidance by removing WKWebView and SFSafariViewController recipes from its representable reference file and demoting web-content ownership.
• Update the README catalog and marketplace metadata to include swiftui-webkit, add it to the swiftui-skills and all-ios-skills bundles, and raise the total skill count from 56 to 57.
• Bump Claude marketplace bundle versions to 2.2.0.

v2.1.1

• Consolidate repeated sibling-skill cross-references in swiftui-patterns into a single scope-boundary note; remove redundant redirect sections and sibling-skill routing from frontmatter description.
• Consolidate repeated apple-on-device-ai cross-references in coreml and remove cross-skill file paths that violated self-containment.
• Bump Claude marketplace bundle versions to 2.1.1.

Highlights

• Rename codable-patterns to swift-codable to improve discoverability and align it with the repo's swift-* taxonomy.
• Tighten discovery wording for swift-codable, alarmkit, app-clips, and app-intents in skill metadata and the README catalog.
• Clarify installation guidance in README.md, including skills CLI usage and the direct install command for all skills.
• Remove stale MCP appendix/tool-note sections from swiftui-liquid-glass, swift-testing, and swiftui-performance, while keeping Release-build and real-device profiling guidance inline in the performance skill.
• Add firebase-debug.log to .gitignore.

Notes

• Marketplace bundle versions are now 2.1.0.
• The changelog has been corrected so v2.0.1 now matches the actual git tag history.

Summary

• add animation(_:body:) guidance to swiftui-animation alongside .animation(_:value:)
• tighten bare .animation(_:) and scoped transaction wording to match Apple documentation more closely
• update swiftui-performance, CHANGELOG.md, and Claude marketplace bundle versions to 2.0.1

New skills (33 added)

SwiftUI (3)

• swiftui-gestures — Tap, drag, magnify, rotate, long press, simultaneous and sequential gestures
• swiftui-layout-components — Grid, LazyVGrid, Layout protocol, ViewThatFits, custom layouts
• swiftui-navigation — NavigationStack, NavigationSplitView, programmatic navigation, deep linking

Core Swift (1)

• swift-language — Swift 6.2 features, macros, result builders, property wrappers

App Experience Frameworks (3)

• alarmkit — AlarmKit alarms and countdown timers, Live Activity integration, AlarmAttributes, AlarmButton
• app-clips — App Clip experiences, invocation, size limits, shared data
• photos-camera-media — PhotosPicker, AVCaptureSession, photo library, video recording, media permissions

Data & Service Frameworks (7)

• cloudkit-sync — CKContainer, CKRecord, subscriptions, sharing, NSPersistentCloudKitContainer
• contacts-framework — CNContactStore, fetch requests, key descriptors, CNContactPickerViewController, save requests
• eventkit-calendar — EKEventStore, EKEvent, EKReminder, recurrence rules, EventKitUI editors and choosers
• healthkit — HKHealthStore, queries, statistics, workout sessions, background delivery
• musickit-audio — MusicKit authorization, catalog search, ApplicationMusicPlayer, MPRemoteCommandCenter
• passkit-wallet — Apple Pay, PKPaymentRequest, PKPaymentAuthorizationController, Wallet passes
• weatherkit — WeatherService, current/hourly/daily forecasts, alerts, attribution requirements

AI & Machine Learning (3)

• coreml — Core ML model loading, prediction, MLTensor, compute unit configuration, VNCoreMLRequest, MLComputePlan
• natural-language — NLTokenizer, NLTagger, sentiment analysis, language identification, embeddings, Translation
• speech-recognition — SFSpeechRecognizer, on-device recognition, audio buffer processing

iOS Engineering (5)

• authentication — Sign in with Apple, ASAuthorizationController, passkeys, biometric auth (LAContext), credential management
• background-processing — BGTaskScheduler, background refresh, URLSession background transfers
• device-integrity — DeviceCheck (DCDevice per-device bits), App Attest (DCAppAttestService attestation and assertion flows)
• metrickit-diagnostics — MXMetricManager, hang diagnostics, crash reports, power metrics
• ios-localization — String Catalogs, pluralization, FormatStyle, right-to-left layout

Hardware & Device Integration (4)

• core-motion — CMMotionManager, CMPedometer, accelerometer, gyroscope, activity recognition, altitude
• core-nfc — NFCNDEFReaderSession, NFCTagReaderSession, NDEF reading/writing, background tag reading
• pencilkit-drawing — PKCanvasView, PKDrawing, PKToolPicker, Apple Pencil, PaperKit integration
• realitykit-ar — RealityView, entities, anchors, ARKit world tracking, raycasting, scene understanding

Platform Integration (7)

• callkit-voip — CXProvider, CXCallController, PushKit VoIP registration, call directory extensions
• energykit — ElectricityGuidance, EnergyVenue, grid forecasts, load event submission, electricity insights
• homekit-matter — HMHomeManager, accessories, rooms, actions, triggers, MatterSupport commissioning
• mapkit-location — MapKit, CoreLocation, annotations, geocoding, directions, geofencing
• permissionkit — AskCenter, PermissionQuestion, child communication safety, CommunicationLimits
• shareplay-activities — GroupActivity, GroupSession, GroupSessionMessenger, coordinated media playback
• apple-on-device-ai — Foundation Models framework, Core ML, MLX Swift, on-device LLM inference

Skill refactors

• swiftui-patterns split into swiftui-patterns, swiftui-navigation, and swiftui-layout-components — each is now self-contained with no cross-references.
• ios-security split into ios-security, authentication, and device-integrity — each owns a clear domain boundary. ios-security covers Keychain/CryptoKit/data protection. authentication covers Sign in with Apple, passkeys, and biometric sign-in. device-integrity covers DeviceCheck and App Attest.
• All skills now self-contained with 4 or fewer reference files. No skill references another skill's files.

Bundle restructure

v1.x had 6 themed bundles + 1 all-skills bundle. v2.0 has 8 themed bundles + 1 all-skills bundle.

Changes:

• ios-framework-skills (17 skills) split into ios-app-framework-skills (10) and ios-data-framework-skills (7).
• New ios-ai-ml-skills bundle created with apple-on-device-ai, coreml, natural-language, speech-recognition, vision-framework.
• AI/ML skills removed from ios-engineering-skills and ios-platform-skills.
• ios-platform-skills trimmed to 5 specialized platform integrations (HomeKit, SharePlay, CallKit, PermissionKit, EnergyKit).
• ios-engineering-skills refocused on 10 core engineering skills (networking, security, auth, accessibility, localization, debugging, diagnostics, background processing, device integrity, App Store review).

Metadata improvements

• All 56 skill descriptions aligned with Agent Skills best practices.
• Bundle descriptions shortened and focused on user intent.
• Missing keywords added for major frameworks (Sendable, async-await, Foundation Models, BLE, Matter, etc.).
• All iOS 26 API claims verified against Apple documentation.

Beta framework caveats

Three skills reference iOS 26 beta-only frameworks that may change before GM:

• permissionkit — PermissionKit (AskCenter, PermissionQuestion, CommunicationLimits)
• energykit — EnergyKit (ElectricityGuidance, EnergyVenue)
• pencilkit-drawing — references PaperKit integration

Migration notes

• Bundle name change: ios-framework-skills no longer exists. Reinstall as ios-app-framework-skills and/or ios-data-framework-skills.
• Skill file paths changed: swiftui-patterns/references/ files were reorganized during the split into three skills. Tools or scripts referencing old paths will need updating.
• No breaking API changes: All skills remain independently installable via npx skills add or /plugin install.