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:
$axiom-swift-concurrency
$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
1---2name: axiom-getting-started3description: Use when first installing Axiom, unsure which skill to use, want an overview of available skills, or need help finding the right skill for your situation — interactive onboarding that recommends skills based on your project and current focus4license: MIT5metadata:6 source: https://skillmd.com/skills/megastep/axiom-getting-started7 version: "1.0.0"8---910# Getting Started with Axiom1112Welcome! This skill helps new users discover the most relevant Axiom skills for their situation.1314## How This Skill Works15161. Ask the user 2-3 targeted questions about their project172. Provide personalized skill recommendations (3-5 skills max)183. Show example prompts they can try immediately194. Include a complete skill reference for browsing2021## Step 1: Ask Questions2223Use the AskUserQuestion tool to gather context:2425### Question 1: Current Focus2627```28Question: "What brings you to Axiom today?"29Header: "Focus"30Options:31- "Debugging an issue" → Prioritize diagnostic skills32- "Optimizing performance" → Prioritize profiling skills33- "Adding new features" → Prioritize reference skills34- "Code review / quality check" → Prioritize audit commands35- "Just exploring" → Show overview36```3738### Question 2: Tech Stack3940```41Question: "What's your primary tech stack?"42Header: "Stack"43Options:44- "SwiftUI (iOS 16+)" → SwiftUI-focused skills45- "UIKit" → UIKit-focused skills46- "Mixed SwiftUI + UIKit" → Both47- "Starting new project" → Best practices skills48```4950### Question 3: Pain Points (Optional, Multi-Select)5152Only ask if "Debugging an issue" was selected:5354```55Question: "Which areas are you struggling with?"56Header: "Pain Points"57Multi-select: true58Options:59- "Xcode/build issues"60- "Memory leaks"61- "UI/animation problems"62- "Database/persistence"63- "Networking"64- "Concurrency/async"65- "Accessibility"66```6768## Step 2: Provide Personalized Recommendations6970Based on answers, recommend 3-5 skills using this matrix:7172### If "Debugging an issue"7374**Always recommend**: axiom:xcode-debugging (universal starting point)7576**Then add based on pain points**:77- Xcode/build → xcode-debugging, axiom-build-debugging78- Memory leaks → memory-debugging, axiom-objc-block-retain-cycles79- UI/animation (SwiftUI) → swiftui-debugging, axiom-swiftui-performance80- UI/animation (UIKit) → uikit-animation-debugging, axiom-auto-layout-debugging81- Database → database-migration, axiom-sqlitedata-migration (decision guide)82- Networking → networking, axiom-networking-diag83- Concurrency → swift-concurrency84- Accessibility → accessibility-diag8586### If "Optimizing performance"8788**SwiftUI stack**:891. performance-profiling (decision trees for tools)902. swiftui-performance (SwiftUI Instrument)913. swiftui-debugging (view update issues)9293**UIKit/Mixed**:941. performance-profiling (Instruments guide)952. memory-debugging (leak detection)963. uikit-animation-debugging (CAAnimation issues)9798### If "Adding new features"99100**Design decisions**:101- hig (quick design decisions, checklists)102- hig-ref (comprehensive HIG reference)103104**iOS 26+ features**:105- liquid-glass (material design system)106- foundation-models (on-device AI)107- swiftui-26-ref (complete iOS 26 guide)108109**Navigation patterns**:110- swiftui-nav (iOS 18+ Tab/Sidebar, deep linking)111- swiftui-nav-ref (comprehensive API reference)112113**Integrations**:114- app-intents-ref (Siri, Shortcuts, Spotlight)115- networking (Network.framework modern patterns)116117**Data persistence**:118- Ask: "Which persistence framework?" → swiftdata, axiom-sqlitedata, or grdb119- Migration: axiom-sqlitedata-migration, axiom-realm-migration-ref120121### If "Code review / quality check"122123**Start with audit commands** (quick wins):1241. `/axiom:audit-accessibility` — WCAG compliance1252. `/axiom:audit-concurrency` — Swift 6 violations1263. `/axiom:audit-memory` — Leak patterns1274. `/axiom:audit-core-data` — Migration safety1285. `/axiom:audit-networking` — Deprecated APIs129130**Then suggest**:131- Review skills based on what audits find132133### If "Just exploring"134135Show the complete skill index (see below) and explain categories.136137## Step 3: Output Format138139After gathering answers, output:140141```markdown142## Your Recommended Skills143144Based on your answers, here are the skills most relevant to you right now:145146### [Icon] [Category Name]147**axiom:[skill-name]** — [One-line description]148> Try: "[Example prompt they can use immediately]"149150[Repeat for 3-5 skills]151152### Quick Wins153Run these audit commands to find issues automatically:154- `/axiom:audit-[name]` — [What it finds]155156## What's Next1571581. **Try the example prompts above** — Copy/paste to see how skills work1592. **Run an audit command** — Get immediate actionable insights1603. **Describe your problem** — I'll suggest the right skill1614. **Browse the complete index below** — Explore all 34 skills162163---164165[Include the Complete Skill Reference below]166```167168## Complete Skill Reference169170Include this reference section in every response for browsing:171172### Debugging & Troubleshooting173174**Environment & Build Issues**175- **xcode-debugging** — BUILD FAILED, simulator hangs, zombie processes, environment-first diagnostics176- **build-debugging** — Dependency conflicts, CocoaPods/SPM failures, Multiple commands produce177178**Memory & Performance**179- **memory-debugging** — Memory growth, retain cycles, leak diagnosis with Instruments180- **performance-profiling** — Decision trees for Instruments (Time Profiler, Allocations, Core Data, Energy)181- **objc-block-retain-cycles** — Objective-C block memory leaks, weak-strong pattern182183**UI Debugging**184- **swiftui-debugging** — View update issues, struct mutation, binding identity, view recreation185- **swiftui-performance** — SwiftUI Instrument (iOS 26), long view bodies, Cause & Effect Graph186- **uikit-animation-debugging** — CAAnimation completion, spring physics, gesture+animation jank187- **auto-layout-debugging** — Auto Layout conflicts, constraint debugging (not yet in manifest)188189### Concurrency & Async190- **swift-concurrency** — Swift 6 strict concurrency, @concurrent, actor isolation, Sendable, data races191192### UI & Design (iOS 26+)193194**Liquid Glass (Material Design)**195- **liquid-glass** — Implementation, Regular vs Clear variants, design review defense196- **liquid-glass-ref** — Complete app-wide adoption guide (icons, controls, navigation, windows)197198**Layout & Navigation**199- **swiftui-layout** — ViewThatFits vs AnyLayout vs onGeometryChange, decision trees, iOS 26 free-form windows200- **swiftui-layout-ref** — Complete layout API reference201- **swiftui-nav** — NavigationStack vs NavigationSplitView, deep links, coordinator patterns, iOS 18+ Tab/Sidebar202- **swiftui-nav-ref** — Comprehensive navigation API reference203- **swiftui-nav-diag** — Navigation not responding, unexpected pops, deep link failures, state loss204205### Testing206- **ui-testing** — Recording UI Automation (Xcode 26), condition-based waiting, accessibility-first patterns207208### Persistence209210**Frameworks**211- **swiftdata** — @Model, @Query, @Relationship, CloudKit, iOS 26 features, Swift 6 concurrency212- **sqlitedata** — Point-Free SQLiteData, @Table, FTS5, CTEs, JSON aggregation, CloudKit sync213- **grdb** — Raw SQL, complex joins, ValueObservation, DatabaseMigrator, performance214- **database-migration** — Safe schema evolution for SQLite/GRDB, additive migrations, prevents data loss215216**Migration Guides**217- **sqlitedata-migration** — Decision guide, pattern equivalents, performance benchmarks218- **realm-migration-ref** — Realm → SwiftData migration (Realm Device Sync sunset Sept 2025)219220### Networking221- **networking** — Network.framework (iOS 12-26), NetworkConnection (iOS 26), structured concurrency222- **networking-diag** — Connection timeouts, TLS failures, data not arriving, performance issues223- **network-framework-ref** — Complete API reference, TLV framing, Coder protocol, Wi-Fi Aware224225### Apple Intelligence (iOS 26+)226- **foundation-models** — On-device AI, LanguageModelSession, @Generable, streaming, tool calling227- **foundation-models-diag** — Context exceeded, guardrails, slow generation, availability issues228- **foundation-models-ref** — Complete API reference, all 26 WWDC examples229230### Design & UI Guidelines231- **hig** — Quick design decisions, color/background/typography choices, HIG compliance checklists232- **hig-ref** — Comprehensive Human Interface Guidelines reference with code examples233234### Integrations235- **app-intents-ref** — Siri, Apple Intelligence, Shortcuts, Spotlight (iOS 16+)236- **swiftui-26-ref** — iOS 26 SwiftUI features, @Animatable, 3D layout, WebView, AttributedString237- **avfoundation-ref** — Audio APIs, bit-perfect DAC, iOS 26 spatial audio, ASAF/APAC238239### Diagnostics (Systematic Troubleshooting)240- **accessibility-diag** — VoiceOver, Dynamic Type, color contrast, WCAG compliance, App Store defense241- **core-data-diag** — Schema migration crashes, thread-confinement, N+1 queries242243### Audit Commands (Quick Scans)244- `/axiom:audit-accessibility` — VoiceOver labels, Dynamic Type, contrast, touch targets245- `/axiom:audit-concurrency` — Swift 6 violations, unsafe tasks, missing @MainActor246- `/axiom:audit-memory` — Timer leaks, observer leaks, closure captures, delegate cycles247- `/axiom:audit-core-data` — Migration risks, thread violations, N+1 queries248- `/axiom:audit-networking` — Deprecated APIs (SCNetworkReachability, CFSocket), anti-patterns249- `/axiom:audit-liquid-glass` — Glass adoption opportunities, toolbar improvements, blur migration250251## Skill Categories Explained252253- **Discipline skills** (no suffix) — Step-by-step workflows with pressure scenarios, TDD-tested254- **Diagnostic skills** (-diag suffix) — Systematic troubleshooting with production crisis defense255- **Reference skills** (-ref suffix) — Comprehensive API guides with WWDC examples256257## Quick Decision Trees258259**"My build is failing"**260→ Start: axiom:xcode-debugging261→ If dependency issue: axiom:build-debugging262263**"App is slow"**264→ Start: axiom:performance-profiling (decision trees)265→ If SwiftUI: axiom:swiftui-performance266→ If memory grows: axiom:memory-debugging267268**"Memory leak"**269→ Start: axiom:memory-debugging270→ If Objective-C blocks: axiom:objc-block-retain-cycles271272**"SwiftUI view issues"**273→ Start: axiom:swiftui-debugging274→ If performance: axiom:swiftui-performance275276**"Navigation problems"**277→ Start: axiom:swiftui-nav-diag (troubleshooting)278→ For patterns: axiom:swiftui-nav279280**"Which database?"**281→ Decision guide: axiom:sqlitedata-migration282→ Then: axiom:swiftdata, axiom:sqlitedata, or axiom:grdb283284**"iOS 26 design"**285→ Start: axiom:liquid-glass286→ Complete guide: axiom:liquid-glass-ref287288**"Code quality check"**289→ Run: `/axiom:audit-accessibility`, `/axiom:audit-concurrency`, `/axiom:audit-memory`290→ Fix issues with relevant skills291292## How Skills Work293294Axiom skills load automatically — you don't need to memorize names or commands.295296**Automatic triggering** (most common): Just describe your problem naturally. Claude detects which skill applies and loads it.297- "My SwiftData CloudKit sync isn't working" → loads `cloud-sync-diag`298- "I'm getting Sendable errors in Swift 6" → loads `swift-concurrency`299300**Explicit invocation**: If you know the skill name, invoke it directly:301- `$axiom-swift-concurrency`302- `$axiom-liquid-glass`303304**Audit commands**: Run automated scans with slash commands:305- `/axiom:audit-memory` — scans for memory leak patterns306- `/axiom:audit-concurrency` — scans for Swift 6 violations307308**Key insight**: You don't need to know skill names. Describe what you're working on and Axiom routes to the right skill automatically.309310## Tips311312- **Describe your problem** — Claude will suggest the right skill313- **Run audits first** — Quick wins with automated scans314- **Start with diagnostic skills** — When troubleshooting specific issues315- **Use reference skills** — When implementing new features316- **All skills are searchable** — Just describe what you need317318---319320**Total**: 50 skills, 12 audit commands, covering the complete iOS development lifecycle from design to deployment