Run an accessibility audit

App Store submission soon; you want VoiceOver/Dynamic Type covered. App passes a basic VoiceOver walk-through.

Axiom (xOS Dev Skills) — Install & Live Demo

Why use it

Key features

SwiftUI-first patterns; UIKit only where required
@Observable (iOS 17+) ViewModels with proper actor isolation
Structured concurrency — flags Task leaks, missing cancellation
Value-type bias; struct/enum over class unless needed
Accessibility audit (VoiceOver, Dynamic Type, contrast)
App Store readiness checklist
Xcode project hygiene — no manual .pbxproj edits

Live Demo

What it looks like in practice

ready

Install

Pick your client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "axiom-xos-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/CharlesWiltgen/Axiom",
        "~/.claude/skills/axiom"
      ],
      "_inferred": true
    }
  }
}

Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "axiom-xos-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/CharlesWiltgen/Axiom",
        "~/.claude/skills/axiom"
      ],
      "_inferred": true
    }
  }
}

Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "axiom-xos-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/CharlesWiltgen/Axiom",
        "~/.claude/skills/axiom"
      ],
      "_inferred": true
    }
  }
}

Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "axiom-xos-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/CharlesWiltgen/Axiom",
        "~/.claude/skills/axiom"
      ],
      "_inferred": true
    }
  }
}

Same shape as Claude Desktop. Restart Windsurf to pick up changes.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "axiom-xos-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/CharlesWiltgen/Axiom",
        "~/.claude/skills/axiom"
      ]
    }
  ]
}

Continue uses an array of server objects rather than a map.

~/.config/zed/settings.json

{
  "context_servers": {
    "axiom-xos-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/CharlesWiltgen/Axiom",
          "~/.claude/skills/axiom"
        ]
      }
    }
  }
}

Add to context_servers. Zed hot-reloads on save.

claude mcp add axiom-xos-skill -- git clone https://github.com/CharlesWiltgen/Axiom ~/.claude/skills/axiom

One-liner. Verify with claude mcp list. Remove with claude mcp remove.

Use Cases

Real-world ways to use Axiom (xOS Dev Skills)

Migrate a ViewModel to @Observable

👤 iOS devs adopting iOS 17+ ⏱ ~45 min advanced

When to use: App is iOS 17+ but ViewModels still ObservableObject + @Published.

Prerequisites

Skill installed — git clone https://github.com/CharlesWiltgen/Axiom ~/.claude/skills/axiom
Min iOS 17 deployment target — Project settings

Flow

Inventory

Axiom: list every ObservableObject + @Published in the project. Note which are leaf vs shared.✓ Copied

→ List with shape + dependency hints
Migrate one

Refactor ProfileViewModel to @Observable. Keep the public API stable. Update its View consumers' bindings.✓ Copied

→ VM migrated; @Bindable used in views; no @Published left
Verify

Run xcodebuild for the scheme. Report any warnings.✓ Copied

→ Clean build; no Swift 6 warnings

Outcome: Modern @Observable codebase with cleaner views.

Pitfalls

Existing tests rely on @Published projection ($name) — Tests need rewriting; not all access patterns map directly

Combine with: filesystem · ios-simulator-mcp

Fix Swift 6 concurrency warnings

👤 iOS devs preparing for Swift 6 strict concurrency ⏱ ~60 min advanced

When to use: Build is yellow with Sendable / actor warnings.

Flow

Triage

Axiom concurrency-clean: classify warnings into: (1) actor isolation, (2) Sendable conformance, (3) data race risk.✓ Copied

→ Categorized list
Fix actor isolation

Tackle category 1 first. Propose minimal fixes; prefer @MainActor on UI types over global isolation.✓ Copied

→ Surgical changes; no blanket @MainActor sprinkling

Outcome: Clean Swift 6 build with intentional concurrency boundaries.

Pitfalls

Overusing @MainActor as a 'silence the warnings' shortcut — Skill flags this; use proper actor design instead

Combinations

Pair with other MCPs for X10 leverage

axiom-xos-skill + ios-simulator-mcp

Apply skill recommendations + smoke test on sim

Axiom: migrate ProfileVM. Then iOS-Simulator: launch, screenshot the profile screen.✓ Copied

axiom-xos-skill + filesystem

Apply patches across the project

Axiom concurrency-clean: produce patches for src/. Filesystem: apply them.✓ Copied

axiom-xos-skill + xcodebuildmcp

Build verification after refactor

After migration, XcodeBuild: build for sim. Report warnings.✓ Copied

Tools

What this MCP exposes

Tool	Inputs	When to call
vm_migrate_observable	viewmodel_path	Per-VM migration
concurrency_clean	scope	Swift 6 prep
a11y_scan	scope	Pre-release
appstore_checklist	(none)	Pre-submission
xcode_hygiene	project	Periodic cleanup

Cost & Limits

What this costs to run

API quota: N/A
Tokens per call: Project scans 10k–40k tokens
Monetary: Free
Tip: Scope audits to one feature/folder; don't fan out across a giant app

Security

Permissions, secrets, blast radius

Minimum scopes: filesystem-read filesystem-write

Credential storage: None

Data egress: None

Skill is opinionated; if your team uses UIKit-first or Combine, expect friction

Troubleshooting

Common errors and fixes

Migration broke @Bindable usage

Some views need @Bindable wrappers; skill should add them — check it didn't miss any

Concurrency fixes silently change semantics

Always run tests post-migration; concurrency changes are subtle

A11y suggestions feel boilerplate

Skill follows Apple HIG; tighten with your own labels

Alternatives

Axiom (xOS Dev Skills) vs others

Alternative	When to use it instead	Tradeoff
AvdLee Swift Concurrency Skill	You only need concurrency, not the broader bundle	Narrower
Apple's own Swift Migrator	You want Apple-blessed migration	Less interactive; less project-aware
twostraws SwiftUI Agent Skill	SwiftUI-only focus	Different opinions

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills