axiom

Battle-tested Claude Code agents, skills, and references for modern xOS (iOS, iPadOS, watchOS, tvOS) development

Installation

npx claude-plugins install @CharlesWiltgen/axiom-marketplace/axiom

Contents

Folders: agents, commands, hooks, skills

Files: README.md, claude-code.json

Documentation

Comprehensive iOS development skills for Claude Code with the latest WWDC 2025 guidance — Apple Intelligence (Foundation Models), Liquid Glass, Widgets & Extensions, SwiftUI Performance, Recording UI Automation, systematic debugging, Swift concurrency, and safe persistence patterns.

Version: 0.9.35 Status: Preview Release Skills: 50 | Commands: 15 | Agents: 13 | Hooks: 4

Installation

In Claude Code, run:

/plugin marketplace add CharlesWiltgen/Axiom

Then search for “axiom” in the /plugin menu and install.

Hooks

Axiom includes 4 automatic hooks that trigger on specific events to enhance your workflow:

1. Build Failure Auto-Trigger

Event: After Bash command execution Trigger: When xcodebuild fails with non-zero exit Action: Suggests running /axiom-fix-build for automatic diagnostics

2. Session Environment Check

Event: Session start Action: Checks for common environment issues:

• Zombie xcodebuild processes (warns if >5)
• Large Derived Data (warns if >10GB)

Output: Silent if no issues detected

3. Core Data Model Protection

Event: Before Edit/Write operations Trigger: Editing .xcdatamodeld files Action: Warns about migration planning risks, suggests running /axiom-audit-core-data

4. Swift Auto-Format

Event: After Write/Edit operations Trigger: Swift files modified Action: Runs swiftformat to ensure consistent code style Requirement: swiftformat must be installed (brew install swiftformat)

Skills

🆕 WWDC 2025 Skills

axiom-liquid-glass

Apple’s new material design system (iOS 26+) with expert review checklist for validating implementations.

Use when: Implementing Liquid Glass effects, reviewing UI for adoption, debugging visual artifacts, requesting expert review

Key features:

• Expert Review Checklist (7 sections)
• Regular vs Clear variant decision criteria
• Layered system architecture
• Troubleshooting and migration patterns

Requirements: iOS 26+, Xcode 26+

axiom-swiftui-performance

Master the new SwiftUI Instrument in Instruments 26, eliminate long view body updates and unnecessary updates.

Use when: App feels sluggish, animations stutter, scrolling performance issues, SwiftUI bottlenecks

Key features:

• New SwiftUI Instrument walkthrough
• Cause & Effect Graph for data flow visualization
• Long view body updates diagnosis
• Unnecessary updates elimination
• Performance optimization checklist

Requirements: Xcode 26+, iOS 26+ SDK

axiom-ui-testing

Recording UI Automation (Xcode 26) with condition-based waiting patterns.

Use when: Writing UI tests, recording interactions, flaky tests, race conditions

Key features:

• Recording UI Automation (Record → Replay → Review)
• Condition-based waiting (eliminates sleep() timeouts)
• Accessibility-first testing
• Real-world impact: 15 min → 5 min test suite

Requirements: Xcode 26+ for Recording UI Automation

axiom-apple-docs-research

Research methodology for Apple frameworks using Chrome browser WWDC transcript capture and sosumi.ai documentation.

Use when: Researching Apple frameworks, retrieving WWDC transcripts, looking up API documentation, creating skills from Apple sources

Key features:

• Chrome auto-capture of full WWDC transcripts with timestamps
• sosumi.ai URL patterns for clean markdown documentation
• Complete workflows for feature research
• Time saved: 30-40 min per WWDC session vs manual watching

Impact: 3-4 hours saved per comprehensive research task

📱 Widgets & Extensions

axiom-extensions-widgets

Discipline-enforcing skill for widgets, Live Activities, and Control Center controls with anti-patterns and pressure scenarios.

Use when: Implementing widgets, debugging refresh issues, sharing data between app and extension, Live Activity issues

Key features:

• 7 anti-patterns with time costs (2-4 hours debugging prevented)
• Decision tree for symptom-based debugging
• 3 pressure scenarios with phased strategies
• Mandatory checklists (pre-release + post-release)
• 80% rationalization prevention rate

TDD Tested: Grade A+ from pressure testing

axiom-extensions-widgets-ref (Reference)

Comprehensive API reference for WidgetKit, ActivityKit, Control Center widgets, and extension lifecycle (iOS 14+).

Use when: API lookups, understanding widget families, timeline system details, Live Activities implementation, Control Center widgets

Key features:

• 11 parts covering all widget types (2250+ lines)
• Troubleshooting section (10 common scenarios)
• “Building Your First Widget” workflow (10 steps)
• Expert review checklist (50+ items)
• Complete testing guidance
• Performance implications and optimization strategies

Platforms: iOS 14+, iPadOS 14+, watchOS 9+, macOS 11+, visionOS 2+

🔧 Debugging & Trouble

Included Skills

This plugin includes 5 skill definitions:

axiom-accessibility-diag

Use when fixing VoiceOver issues, Dynamic Type violations, color contrast failures, touch target problems, keyboard navigation gaps, or Reduce Motion support - comprehensive accessibility diagnostics with WCAG compliance, Accessibility Inspector workflows, and App Store Review preparation for iOS/macOS

// ❌ WRONG - No label (VoiceOver says "Button")
Button(action: addToCart) {
  Image(systemName: "cart.badge.plus")
}

// ❌ WRONG - Generic label
.accessibilityLabel("Button")

// ❌ WRONG - Reads implementation details
.accessibilityLabel("cart.badge.plus") // VoiceOver: "cart dot badge dot plus"

// ✅ CORRECT - Desc

...(truncated)

</details>

### axiom-app-composition

> Use when structuring app entry points, managing authentication flows, switching root views, handling scene lifecycle, or asking 'how do I structure my @main', 'where does auth state live', 'how do I prevent screen flicker on launch', 'when should I modularize' - app-level composition patterns for iOS 26+

<details>
<summary>View skill definition</summary>

# App Composition

## When to Use This Skill

Use this skill when:
- Structuring your @main entry point and root view
- Managing authentication state (login → onboarding → main)
- Switching between app-level states without flicker
- Handling scene lifecycle events (scenePhase)
- Restoring app state after termination
- Deciding when to split into feature modules
- Coordinating between multiple windows (iPad, axiom-visionOS)

## Example Prompts

| What You Might Ask | Why This Skill Helps |
|--------------------|----------------------|
| "How do I switch between login and main screens?" | AppStateController pattern with validated transitions |
| "My app flickers when switching from splash to main" | Flicker prevention with animation coordination |
| "Where should auth state live?" | App-level state machine, not scattered booleans |
| "How do I handle app going to background?" | scenePhase lifecycle patterns |
| "When should I split my app into modules?" | Decision tree based on codebase size and team |
| "How do I restore state after app is killed?" | SceneStorage and state validation patterns |

## Quick Decision Tree

axiom-app-discoverability

Use when making app surface in Spotlight search, Siri suggestions, or system experiences - covers the 6-step strategy combining App Intents, App Shortcuts, Core Spotlight, and NSUserActivity to feed the system metadata for iOS 16+

axiom-app-intents-ref

Use when integrating App Intents for Siri, Apple Intelligence, Shortcuts, Spotlight, or system experiences - covers AppIntent, AppEntity, parameter handling, entity queries, background execution, authentication, and debugging common integration issues for iOS 16+

axiom-app-shortcuts-ref

Use when implementing App Shortcuts for instant Siri/Spotlight availability, configuring AppShortcutsProvider, adding suggested phrases, or debugging shortcuts not appearing - covers complete App Shortcuts API for iOS 16+

Source

View on GitHub