Getting Started with Axiom

Welcome! This skill helps new users discover the most relevant Axiom skills for their situation.

How This Skill Works

Ask the user 2-3 targeted questions about their project
Provide personalized skill recommendations (3-5 skills max)
Show example prompts they can try immediately
Include a complete skill reference for browsing

Step 1: Ask Questions

Use the AskUserQuestion tool to gather context:

Question 1: Current Focus

Question: "What brings you to Axiom today?"
Header: "Focus"
Options:
- "Debugging an issue" → Prioritize diagnostic skills
- "Optimizing performance" → Prioritize profiling skills
- "Adding new features" → Prioritize reference skills
- "Code review / quality check" → Prioritize audit commands
- "Just exploring" → Show overview

Question 2: Tech Stack

Question: "What's your primary tech stack?"
Header: "Stack"
Options:
- "SwiftUI (iOS 16+)" → SwiftUI-focused skills
- "UIKit" → UIKit-focused skills
- "Mixed SwiftUI + UIKit" → Both
- "Starting new project" → Best practices skills

Question 3: Pain Points (Optional, Multi-Select)

Only ask if "Debugging an issue" was selected:

Question: "Which areas are you struggling with?"
Header: "Pain Points"
Multi-select: true
Options:
- "Xcode/build issues"
- "Memory leaks"
- "UI/animation problems"
- "Database/persistence"
- "Networking"
- "Concurrency/async"
- "Accessibility"

Step 2: Provide Personalized Recommendations

Based on answers, recommend 3-5 skills using this matrix:

If "Debugging an issue"

Always recommend: axiom:xcode-debugging (universal starting point)

Then add based on pain points:

Xcode/build → xcode-debugging, axiom-build-debugging
Memory leaks → memory-debugging, axiom-objc-block-retain-cycles
UI/animation (SwiftUI) → swiftui-debugging, axiom-swiftui-performance
UI/animation (UIKit) → uikit-animation-debugging, axiom-auto-layout-debugging
Database → database-migration, axiom-sqlitedata-migration (decision guide)
Networking → networking, axiom-networking-diag
Concurrency → swift-concurrency
Accessibility → accessibility-diag

If "Optimizing performance"

SwiftUI stack:

performance-profiling (decision trees for tools)
swiftui-performance (SwiftUI Instrument)
swiftui-debugging (view update issues)

UIKit/Mixed:

performance-profiling (Instruments guide)
memory-debugging (leak detection)
uikit-animation-debugging (CAAnimation issues)

If "Adding new features"

Design decisions:

hig (quick design decisions, checklists)
hig-ref (comprehensive HIG reference)

iOS 26+ features:

liquid-glass (material design system)
foundation-models (on-device AI)
swiftui-26-ref (complete iOS 26 guide)

Navigation patterns:

swiftui-nav (iOS 18+ Tab/Sidebar, deep linking)
swiftui-nav-ref (comprehensive API reference)

Integrations:

app-intents-ref (Siri, Shortcuts, Spotlight)
networking (Network.framework modern patterns)

Data persistence:

Ask: "Which persistence framework?" → swiftdata, axiom-sqlitedata, or grdb
Migration: axiom-sqlitedata-migration, axiom-realm-migration-ref

If "Code review / quality check"

Start with audit commands (quick wins):

/axiom:audit-accessibility — WCAG compliance
/axiom:audit-concurrency — Swift 6 violations
/axiom:audit-memory — Leak patterns
/axiom:audit-core-data — Migration safety
/axiom:audit-networking — Deprecated APIs

Then suggest:

Review skills based on what audits find

If "Just exploring"

Show the complete skill index (see below) and explain categories.

Step 3: Output Format

After gathering answers, output:

## Your Recommended Skills

Based on your answers, here are the skills most relevant to you right now:

### [Icon] [Category Name]
**axiom:[skill-name]** — [One-line description]
> Try: "[Example prompt they can use immediately]"

[Repeat for 3-5 skills]

### Quick Wins
Run these audit commands to find issues automatically:
- `/axiom:audit-[name]` — [What it finds]

## What's Next

1. **Try the example prompts above** — Copy/paste to see how skills work
2. **Run an audit command** — Get immediate actionable insights
3. **Describe your problem** — I'll suggest the right skill
4. **Browse the complete index below** — Explore all 34 skills

---

[Include the Complete Skill Reference below]

Complete Skill Reference

Include this reference section in every response for browsing:

Debugging & Troubleshooting

Environment & Build Issues

xcode-debugging — BUILD FAILED, simulator hangs, zombie processes, environment-first diagnostics
build-debugging — Dependency conflicts, CocoaPods/SPM failures, Multiple commands produce

Memory & Performance

memory-debugging — Memory growth, retain cycles, leak diagnosis with Instruments
performance-profiling — Decision trees for Instruments (Time Profiler, Allocations, Core Data, Energy)
objc-block-retain-cycles — Objective-C block memory leaks, weak-strong pattern

UI Debugging

swiftui-debugging — View update issues, struct mutation, binding identity, view recreation
swiftui-performance — SwiftUI Instrument (iOS 26), long view bodies, Cause & Effect Graph
uikit-animation-debugging — CAAnimation completion, spring physics, gesture+animation jank
auto-layout-debugging — Auto Layout conflicts, constraint debugging (not yet in manifest)

Concurrency & Async

swift-concurrency — Swift 6 strict concurrency, @concurrent, actor isolation, Sendable, data races

UI & Design (iOS 26+)

Liquid Glass (Material Design)

liquid-glass — Implementation, Regular vs Clear variants, design review defense
liquid-glass-ref — Complete app-wide adoption guide (icons, controls, navigation, windows)

Layout & Navigation

swiftui-layout — ViewThatFits vs AnyLayout vs onGeometryChange, decision trees, iOS 26 free-form windows
swiftui-layout-ref — Complete layout API reference
swiftui-nav — NavigationStack vs NavigationSplitView, deep links, coordinator patterns, iOS 18+ Tab/Sidebar
swiftui-nav-ref — Comprehensive navigation API reference
swiftui-nav-diag — Navigation not responding, unexpected pops, deep link failures, state loss

Testing

ui-testing — Recording UI Automation (Xcode 26), condition-based waiting, accessibility-first patterns

Persistence

Frameworks

swiftdata — @Model, @Query, @Relationship, CloudKit, iOS 26 features, Swift 6 concurrency
sqlitedata — Point-Free SQLiteData, @Table, FTS5, CTEs, JSON aggregation, CloudKit sync
grdb — Raw SQL, complex joins, ValueObservation, DatabaseMigrator, performance
database-migration — Safe schema evolution for SQLite/GRDB, additive migrations, prevents data loss

Migration Guides

sqlitedata-migration — Decision guide, pattern equivalents, performance benchmarks
realm-migration-ref — Realm → SwiftData migration (Realm Device Sync sunset Sept 2025)

Networking

networking — Network.framework (iOS 12-26), NetworkConnection (iOS 26), structured concurrency
networking-diag — Connection timeouts, TLS failures, data not arriving, performance issues
network-framework-ref — Complete API reference, TLV framing, Coder protocol, Wi-Fi Aware

Apple Intelligence (iOS 26+)

foundation-models — On-device AI, LanguageModelSession, @Generable, streaming, tool calling
foundation-models-diag — Context exceeded, guardrails, slow generation, availability issues
foundation-models-ref — Complete API reference, all 26 WWDC examples

Design & UI Guidelines

hig — Quick design decisions, color/background/typography choices, HIG compliance checklists
hig-ref — Comprehensive Human Interface Guidelines reference with code examples

Integrations

app-intents-ref — Siri, Apple Intelligence, Shortcuts, Spotlight (iOS 16+)
swiftui-26-ref — iOS 26 SwiftUI features, @Animatable, 3D layout, WebView, AttributedString
avfoundation-ref — Audio APIs, bit-perfect DAC, iOS 26 spatial audio, ASAF/APAC

Diagnostics (Systematic Troubleshooting)

accessibility-diag — VoiceOver, Dynamic Type, color contrast, WCAG compliance, App Store defense
core-data-diag — Schema migration crashes, thread-confinement, N+1 queries

Audit Commands (Quick Scans)

/axiom:audit-accessibility — VoiceOver labels, Dynamic Type, contrast, touch targets
/axiom:audit-concurrency — Swift 6 violations, unsafe tasks, missing @MainActor
/axiom:audit-memory — Timer leaks, observer leaks, closure captures, delegate cycles
/axiom:audit-core-data — Migration risks, thread violations, N+1 queries
/axiom:audit-networking — Deprecated APIs (SCNetworkReachability, CFSocket), anti-patterns
/axiom:audit-liquid-glass — Glass adoption opportunities, toolbar improvements, blur migration

Skill Categories Explained

Discipline skills (no suffix) — Step-by-step workflows with pressure scenarios, TDD-tested
Diagnostic skills (-diag suffix) — Systematic troubleshooting with production crisis defense
Reference skills (-ref suffix) — Comprehensive API guides with WWDC examples

Quick Decision Trees

"My build is failing" → Start: axiom:xcode-debugging → If dependency issue: axiom:build-debugging

"App is slow" → Start: axiom:performance-profiling (decision trees) → If SwiftUI: axiom:swiftui-performance → If memory grows: axiom:memory-debugging

"Memory leak" → Start: axiom:memory-debugging → If Objective-C blocks: axiom:objc-block-retain-cycles

"SwiftUI view issues" → Start: axiom:swiftui-debugging → If performance: axiom:swiftui-performance

"Navigation problems" → Start: axiom:swiftui-nav-diag (troubleshooting) → For patterns: axiom:swiftui-nav

"Which database?" → Decision guide: axiom:sqlitedata-migration → Then: axiom:swiftdata, axiom:sqlitedata, or axiom:grdb

"iOS 26 design" → Start: axiom:liquid-glass → Complete guide: axiom:liquid-glass-ref

"Code quality check" → Run: /axiom:audit-accessibility, /axiom:audit-concurrency, /axiom:audit-memory → Fix issues with relevant skills

How Skills Work

Axiom skills load automatically — you don't need to memorize names or commands.

Automatic triggering (most common): Just describe your problem naturally. Claude detects which skill applies and loads it.

"My SwiftData CloudKit sync isn't working" → loads cloud-sync-diag
"I'm getting Sendable errors in Swift 6" → loads swift-concurrency

Explicit invocation: If you know the skill name, invoke it directly:

/skill axiom-swift-concurrency
/skill axiom-liquid-glass

Audit commands: Run automated scans with slash commands:

/axiom:audit-memory — scans for memory leak patterns
/axiom:audit-concurrency — scans for Swift 6 violations

Key insight: You don't need to know skill names. Describe what you're working on and Axiom routes to the right skill automatically.

Tips

Describe your problem — Claude will suggest the right skill
Run audits first — Quick wins with automated scans
Start with diagnostic skills — When troubleshooting specific issues
Use reference skills — When implementing new features
All skills are searchable — Just describe what you need

Total: 50 skills, 12 audit commands, covering the complete iOS development lifecycle from design to deployment

axiom-getting-started