Axiom Apple Docs
Route your coding agent to authoritative Apple for-LLM markdown inside Xcode when you need exact Swift API behavior, framework guides, or compiler diagnostic explanations.
Overview
axiom-apple-docs is an agent skill most often used in Build (also Ship, Validate) that routes agents to Xcode-bundled Apple for-LLM documentation via the Read tool for authoritative Swift and framework answers.
Install
npx skills add https://github.com/charleswiltgen/axiom --skill axiom-apple-docsWhat is this skill?
- Read Apple for-LLM markdown from Xcode PlugIns paths with Claude Code Read—no MCP server
- Covers Liquid Glass, Swift 6.2 concurrency, Foundation Models, SwiftData, StoreKit, and 32 Swift compiler diagnostics
- Session hook echoes detected Xcode base paths for literal Read targets
- Pairs with Axiom skills: opinionated guidance plus Apple-authored API details
- Priority order: framework questions, referenced skills, diagnostics, feature deep-dives
- 32 Swift compiler diagnostics referenced
- Guides include Liquid Glass, Swift 6.2 concurrency, Foundation Models, SwiftData, StoreKit
Adoption & trust: 567 installs on skills.sh; 956 GitHub stars; 1/3 security scanners passed (skills.sh audits).
What problem does it solve?
You are building on Apple platforms and need exact API behavior or compiler diagnostic meaning without trusting generic web summaries or invented signatures.
Who is it for?
Solo builders using Claude Code or similar agents on Swift/SwiftUI projects with Xcode installed who want on-machine Apple docs in the loop.
Skip if: Teams without Xcode or Apple toolchain who only need cross-platform web docs, or tasks with zero Apple framework involvement.
When should I use this skill?
ANY question involves Apple framework APIs, Swift compiler errors, or Xcode-bundled documentation—or an Axiom skill references an Apple framework.
What do I get? / Deliverables
Your agent reads the correct on-disk Apple markdown for the framework or diagnostic in question, so implementation and fixes align with Apple’s own text.
- Targeted Read of official Apple for-LLM markdown
- Diagnostic explanation grounded in Apple-authored text
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Canonical shelf is Build because Apple API work happens while implementing iOS/macOS features, with docs as the official reference layer. Subphase docs matches reading Xcode-bundled guides and diagnostics via the native Read tool—not a third-party doc site.
Where it fits
Spike Foundation Models entitlements wording from AdditionalDocumentation before committing to an on-device AI feature.
Pull Liquid Glass and SwiftUI layout guidance while implementing a new navigation chrome.
Verify StoreKit 2 transaction listener APIs against apple-reference documentation during checkout integration.
Map a Swift 6 concurrency diagnostic ID to Apple’s explained fix before merging a strict-concurrency refactor.
How it compares
Use as an on-disk doc router inside the agent session—not a hosted Apple Developer MCP or generic web search skill.
Common Questions / FAQ
Who is axiom-apple-docs for?
Indie and solo developers building iOS, macOS, visionOS, or Swift packages who want their agent to cite Apple’s bundled LLM-oriented docs instead of guessing APIs.
When should I use axiom-apple-docs?
During Build when implementing StoreKit or SwiftData; during Ship when unpacking Swift compiler diagnostics; during Validate when prototyping a Foundation Models feature and you need official capability wording.
Is axiom-apple-docs safe to install?
It only instructs the agent to read local Xcode documentation paths; review the Security Audits panel on this Prism page and confirm the skill matches your repo’s trust bar before enabling.
SKILL.md
READMESKILL.md - Axiom Apple Docs
# Apple Documentation Router Apple bundles for-LLM markdown documentation inside Xcode. These are authoritative, up-to-date guides and diagnostics written by Apple engineers. Read them directly with Claude Code's native **`Read`** tool — no MCP server or special tool required. ## When to Use - You need the exact API signature or behavior from Apple - An Axiom skill references an Apple framework and you want the official source - A Swift compiler diagnostic needs explanation - The user asks about a specific Apple framework feature **Priority**: Axiom skills provide opinionated guidance (decision trees, anti-patterns, pressure scenarios). Apple docs provide authoritative API details. Use both together. ## How to Read These Docs The session-start hook resolves Xcode's location and echoes the literal base directories into session context (look for "Apple for-LLM Documentation: Xcode detected at `<path>`"). Use the **`Read`** tool with `<that base>/<filename>`. Default Xcode location (`/Applications/Xcode.app`) base directories: | Content | Base directory | |---|---| | AdditionalDocumentation guides | `/Applications/Xcode.app/Contents/PlugIns/IDEIntelligenceChat.framework/Versions/A/Resources/AdditionalDocumentation/` | | Swift compiler diagnostics | `/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/share/doc/swift/diagnostics/` | Example invocation Claude should produce: ``` Read /Applications/Xcode.app/Contents/PlugIns/IDEIntelligenceChat.framework/Versions/A/Resources/AdditionalDocumentation/SwiftUI-Implementing-Liquid-Glass-Design.md ``` Xcode-beta users: the session-start hook respects `AXIOM_XCODE_PATH` and reports the resolved path in session context — use that path, not the default above. ## Guide Files (AdditionalDocumentation) 20 files. Read with the path pattern `{guides base}/{filename}`. ### UI & Design | Topic | Filename | |---|---| | Liquid Glass in SwiftUI | `SwiftUI-Implementing-Liquid-Glass-Design.md` | | Liquid Glass in UIKit | `UIKit-Implementing-Liquid-Glass-Design.md` | | Liquid Glass in AppKit | `AppKit-Implementing-Liquid-Glass-Design.md` | | Liquid Glass in WidgetKit | `WidgetKit-Implementing-Liquid-Glass-Design.md` | | SwiftUI new toolbar features | `SwiftUI-New-Toolbar-Features.md` | | SwiftUI styled text editing | `SwiftUI-Styled-Text-Editing.md` | | SwiftUI WebKit integration | `SwiftUI-WebKit-Integration.md` | | SwiftUI AlarmKit integration | `SwiftUI-AlarmKit-Integration.md` | | Swift Charts 3D visualization | `Swift-Charts-3D-Visualization.md` | | Foundation AttributedString updates | `Foundation-AttributedString-Updates.md` | ### Data & Persistence | Topic | Filename | |---|---| | SwiftData class inheritance | `SwiftData-Class-Inheritance.md` | ### Concurrency & Performance | Topic | Filename | |---|---| | Swift concurrency updates | `Swift-Concurrency-Updates.md` | | InlineArray and Span | `Swift-InlineArray-Span.md` | ### Apple Intelligence | Topic | Filename | |---|---| | Foundation Models (on-device LLM) | `FoundationModels-Using-on-device-LLM-in-your-app.md` | ### System Integration | Topic | Filename | |---|---| | App Intents updates | `AppIntents-Updates.md` | | StoreKit updates | `StoreKit-Updates.md` | | MapKit GeoToolbox PlaceDescriptors | `MapKit-GeoToolbox-PlaceDescriptors.md` | | Widgets for visionOS | `Widgets-for-visionOS.md` | ### Accessibility | Topic | Filename | |---|---| | Assistive Access in iOS | `Implementing-Assistive-Access-in-iOS.md` | ### Computer Vision | Topic | Filename | |---|---| | Visual Intelligence in iOS | `Implementing-Visual-Intelligence-in-iOS.md` | ## Swift Compiler Diagnostics 46 files in the diagnostics directory. Read w