Battle-tested Claude Code skills, commands, and references for modern xOS (iOS, iPadOS, tvOS, watchOS) development — Swift 6, SwiftUI, Liquid Glass, Apple Intelligence, and more.
- SwiftUI 26 Features — Comprehensive guide to iOS 26 SwiftUI: Liquid Glass, WebView, AttributedString rich text, @Animatable macro, 3D charts, scene bridging, and more
- SwiftUI Performance Enhancements — iOS 26 framework improvements: 6x/16x faster lists, improved scrolling, nested ScrollView optimization
- Liquid Glass APIs — New iOS 26 APIs:
.glassBackgroundEffect(), toolbar spacers, bottom-aligned search, search tab role - App Intents Integration — Siri, Apple Intelligence, Shortcuts, Spotlight integration with WWDC 2025-260 guidance
- Energy Optimization — Power Profiler workflows, subsystem diagnosis (CPU/GPU/Network/Location/Display), anti-pattern fixes for battery drain
- Accessibility Audit & Debugging — Comprehensive WCAG compliance scanning, VoiceOver testing, Dynamic Type support, color contrast validation
- Realm to SwiftData Migration — Migrate before Device Sync sunset (Sept 30, 2025) without losing user data or breaking threading patterns
- SwiftUI Debugging — Solve intermittent view updates and preview crashes with diagnostic decision trees
plugins/- Claude Code plugins for iOS development workflowsdocs/- VitePress documentation sitescratch/- Local development files (not tracked in git)notes/- Personal notes (not tracked in git)
- macOS 15+ (Sequoia or later)
- Claude Code (download here)
- Xcode 26+ (for Liquid Glass, Recording UI Automation, and latest iOS features)
- iOS 26 SDK (comes with Xcode 26)
In Claude Code, run:
/plugin marketplace add CharlesWiltgen/Axiom
Then search for "axiom" in the /plugin menu and install.
Use /plugin and select "Manage and install" to see installed plugins. Axiom should be listed.
Skills are automatically suggested by Claude Code based on your questions and context. Simply ask questions that match the skill's purpose:
- "I'm getting BUILD FAILED in Xcode" → activates
axiom-xcode-debugging - "How do I fix Swift 6 concurrency errors?" → activates
axiom-swift-concurrency - "I need to add a database column safely" → activates
axiom-database-migration - "My app has memory leaks" → activates
axiom-memory-debugging - "My app drains battery quickly" → activates
axiom-energy - "Help me migrate from Realm to SwiftData" → activates
realm-to-swiftdata-migration
Apple's new material design system for iOS 26+. Comprehensive coverage of Liquid Glass visual properties, implementation patterns, and design principles.
- Expert Review Checklist — 7-section validation checklist for reviewing Liquid Glass implementations (material appropriateness, variant selection, legibility, layering, accessibility, performance)
- Regular vs Clear variant decision criteria
- Layered system architecture (highlights, shadows, glow, tinting)
- Troubleshooting visual artifacts, dark mode issues, performance
- Migration from UIBlurEffect/NSVisualEffectView
- Complete API reference with code examples
When to use Implementing Liquid Glass effects, reviewing UI for adoption, debugging visual artifacts, requesting expert review of implementations
Requirements iOS 26+, Xcode 26+
Command /audit-liquid-glass for quick automated codebase scanning
Master SwiftUI performance optimization using the new SwiftUI Instrument in Instruments 26.
- New SwiftUI Instrument walkthrough (4 track lanes, color-coding, integration with Time Profiler)
- Cause & Effect Graph — Visualize data flow and dependencies to eliminate unnecessary updates
- Problem 1: Long View Body Updates (formatter caching, expensive operations)
- Problem 2: Unnecessary View Updates (granular dependencies, AttributeGraph)
- Performance optimization checklist
- Real-world impact examples from WWDC's Landmarks app
When to use App feels less responsive, animations stutter, scrolling performance issues, profiling reveals SwiftUI bottlenecks
Requirements Xcode 26+, iOS 26+ SDK
Comprehensive reference guide to all iOS 26 SwiftUI features from WWDC 2025-256.
- Liquid Glass Design System — Toolbar spacers, tinted prominent buttons, glass effect for custom views, bottom-aligned search, search tab role
- Performance Improvements — 6x/16x faster lists (macOS), improved scrolling, nested ScrollView optimization
- @Animatable Macro — Automatic animatableData synthesis with @AnimatableIgnored
- WebView & WebPage — Native web content, observable model for rich interaction
- TextEditor with AttributedString — Rich text editing with built-in formatting controls
- Drag and Drop Enhancements — Multi-item dragging, DragConfiguration, preview formations
- 3D Charts — Chart3D for three-dimensional plotting
- 3D Spatial Layout — Alignment3D, .spatialOverlay, .manipulable (visionOS)
- Scene Bridging — UIKit/AppKit → SwiftUI scenes, RemoteImmersiveSpace
- Widgets & Controls — visionOS widgets, CarPlay widgets, macOS/watchOS controls
When to use Implementing iOS 26 SwiftUI features, adopting Liquid Glass design, embedding web content, rich text editing, 3D charts/layouts
Requirements iOS 26+, iPadOS 26+, macOS Tahoe+, watchOS 26+, visionOS 26+
Reliable UI testing with condition-based waiting patterns and new Recording UI Automation features from Xcode 26.
- Recording UI Automation — Record interactions as Swift code, replay across devices/languages/configurations, review video recordings
- Three phases: Record → Replay → Review
- Condition-based waiting (eliminates flaky tests from sleep() timeouts)
- Accessibility-first testing patterns
- SwiftUI and UIKit testing strategies
- Test plans and configurations
When to use Writing UI tests, recording interactions, tests have race conditions or timing dependencies, flaky tests
Requirements Xcode 26+ for Recording UI Automation, original patterns work with earlier versions
Diagnostic decision trees for SwiftUI view updates, preview crashes, and layout issues. Includes 3 real-world examples.
- View Not Updating Decision Tree — Diagnose struct mutation, binding identity, view recreation, missing observers
- Preview Crashes Decision Tree — Identify missing dependencies, state init failures, cache corruption
- Layout Issues Quick Reference — ZStack ordering, GeometryReader sizing, SafeArea, frame/fixedSize
- Real-World Examples — List items, preview dependencies, text field bindings with complete diagnosis workflows
- Pressure scenarios for intermittent bugs, App Store Review deadlines, authority pressure resistance
When to use View doesn't update, preview crashes, layout looks wrong, intermittent rendering issues
Requirements Xcode 15+, iOS 14+
Instruments decision trees and profiling workflows for CPU, memory, and battery optimization. Includes 3 real-world examples.
- Performance Decision Tree — Choose the right tool (Time Profiler, Allocations, Core Data, Energy Impact)
- Time Profiler Deep Dive — CPU analysis, hot spots, Self Time vs Total Time distinction
- Allocations Deep Dive — Memory growth diagnosis, object counts, leak vs caching
- Core Data Deep Dive — N+1 query detection with SQL logging, prefetching, batch optimization
- Real-World Examples — N+1 queries, UI lag diagnosis, memory vs leak with complete workflows
- Pressure scenarios for App Store deadlines, manager authority pressure, misinterpretation prevention
When to use App feels slow, memory grows over time, battery drains fast, want to profile proactively
Requirements Xcode 15+, iOS 14+
Comprehensive accessibility diagnostics with WCAG compliance, VoiceOver testing, Dynamic Type support, color contrast validation, and App Store Review preparation.
- 7 critical accessibility issues (VoiceOver labels, Dynamic Type, color contrast, touch targets, keyboard navigation, Reduce Motion, common violations)
- WCAG compliance levels (A, AA, AAA) with code examples
- Accessibility Inspector workflows
- VoiceOver testing checklist
- App Store Review requirements
When to use Fixing VoiceOver issues, Dynamic Type violations, color contrast failures, touch target problems, preparing for App Store Review
Command /audit-accessibility for quick automated scanning
Environment-first diagnostics for mysterious Xcode issues. Prevents 30+ minute rabbit holes by checking build environment before debugging code.
When to use BUILD FAILED, test crashes, simulator hangs, stale builds, zombie xcodebuild processes, "Unable to boot simulator", "No such module" after SPM changes
Systematic memory leak diagnosis with Instruments. 5 leak patterns covering 90% of real-world issues.
When to use App memory grows over time, seeing multiple instances of same class, crashes with memory limit exceeded, Instruments shows retain cycles
Command /prescan-memory for quick triage scanning
Dependency resolution for CocoaPods and Swift Package Manager conflicts.
When to use Dependency conflicts, CocoaPods/SPM resolution failures, "Multiple commands produce" errors, framework version mismatches
Progressive journey from single-threaded to concurrent Swift code. Enhanced with WWDC 2025-268 covering @concurrent attribute, isolated conformances, task interleaving, and approachable concurrency patterns.
- 4-Step Progressive Journey — Single-threaded → Async → Concurrent → Actors
@concurrentattribute (Swift 6.2+) — Force background execution- Isolated conformances — Protocol conformances with specific actor isolation
- Main actor mode — Xcode 26 build settings for approachable concurrency
- 11 copy-paste patterns — Delegates, Sendable types, tasks, persistence
- Decision trees — When to introduce async vs concurrency vs actors
When to use Starting new project, debugging Swift 6 concurrency errors, deciding when to add async/await vs concurrency, offloading CPU-intensive work, implementing @MainActor classes
Requirements Swift 6.0+ (Swift 6.2+ for @concurrent), Xcode 16+
Safe database schema evolution for SQLite/GRDB/SwiftData. Prevents data loss with additive migrations and testing workflows.
When to use Adding/modifying database columns, encountering "FOREIGN KEY constraint failed", "no such column", "cannot add NOT NULL column" errors
SQLiteData (Point-Free) patterns, critical gotchas, batch performance, and CloudKit sync.
When to use Working with SQLiteData @Table models, @FetchAll/@FetchOne queries, StructuredQueries crashes, batch imports
Raw GRDB for complex queries, ValueObservation, DatabaseMigrator patterns.
When to use Writing raw SQL queries, complex joins, ValueObservation for reactive queries, dropping down from SQLiteData for performance
SwiftData with iOS 26+ features, @Model definitions, @Query patterns, Swift 6 concurrency with @MainActor. Enhanced with CloudKit integration patterns, performance optimization, and migration strategies from Realm/Core Data.
When to use Working with SwiftData @Model definitions, @Query in SwiftUI, @Relationship macros, ModelContext patterns, CloudKit integration, performance optimization
What's New: CloudKit constraints & conflict resolution, N+1 query prevention, batch operations, indexes (iOS 26+), migration patterns from Realm and Core Data
Comprehensive guide to App Intents framework for Siri, Apple Intelligence, Shortcuts, and Spotlight integration. Covers AppIntent, AppEntity, parameter handling, entity queries, and debugging.
- Three building blocks: AppIntent, AppEntity, AppEnum
- Parameter validation and natural language summaries
- Entity queries for content discovery
- Background vs foreground execution patterns
- Authentication policies and security
- Testing with Shortcuts app and Siri
- Real-world examples (workouts, tasks, orders)
- Assistant schemas for common app types
When to use Exposing app functionality to Siri/Apple Intelligence, Shortcuts automation, Spotlight search, Focus filters, debugging intent resolution failures
Requirements iOS 16+
Comprehensive migration guide for Realm users facing Device Sync sunset (Sept 30, 2025). Complete path from Realm to SwiftData with pattern equivalents, threading model conversion, schema strategies, and testing checklist.
When to use Migrating from Realm to SwiftData, planning data migration, understanding threading differences, handling CloudKit sync transition, testing for production readiness
Urgency: Realm Device Sync sunset September 30, 2025 - this skill is essential for affected developers
Timeline: 2-8 weeks depending on app complexity
Full documentation available at https://charleswiltgen.github.io/Axiom
This is a preview release. Feedback is welcome!
- Issues: Report bugs or request features at GitHub Issues
- Discussions: Share usage patterns and ask questions at GitHub Discussions