axiom-apple-docs

Use when ANY question involves Apple framework APIs, Swift compiler errors, or Xcode-bundled documentation. Covers Liquid Glass, Swift 6.2 concurrency, Foundation Models, SwiftData, StoreKit, 32 Swift compiler diagnostics.

By charleswiltgen · 1,224 installs

npx skills add charleswiltgen/axiom --skill axiom-apple-docs

Source repository · Upstream listing

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 as files (in Claude Code, with the 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 Axiom's session context names the Xcode the user has switched to. In Claude Code it lists the literal base directories ("Apple for LLM Documentation: Xcode detected at <path "); other harnesses name the app ("Installed on this machine: Xcode … ( <path )") — substitute that .app for /Applications/Xcode.app in the table below. Read <base /<filename as a file (the Read tool in Claude Code). 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: These paths assume the default install; use the path from session context instead. Without session context: use AXIOM XCODE PATH if it is set; otherwise run xcode select p (it honors DEVELOPER DIR ), which prints <Xcode .app/Contents/Developer — drop /Contents/Developer and put that .app in place of /Applications/Xcode.app above. If it prints /Library/Developer/CommandLineTools , no Xcode is selected; try /Applications/Xcode.app . 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 The diagnostics directory ships more files than are listed here (the count varies by Xcode version); the most relevant are below. Read with the path pattern {diagnostics base}/{filename} . Concurrency Diagnostics Diagnostic Filename Actor isolated call from nonisolated context actor isolated call.md Conformance isolation conformance isolation.md Isolated conformances isolated conformances.md Nonisolated nonsending by default nonisolated nonsending by default.md Sendable closure captures sendable closure captures.md Sendable metatypes sendable metatypes.md Explicit Sendable annotations explicit sendable annotations.md Sending closure risks data race sending closure risks data race.md Sending risks data race sending risks data race.md Mutable global variable mutable global variable.md Preconcurrency import preconcurrency import.md Dynamic exclusivity dynamic exclusivity.md Exclusivity violation exclusivity violation.md Type System Diagnostics Diagnostic Filename Existential any existential any.md Existential member access limitations existential member access limitations.md Nominal types nominal types.md Multiple inheritance multiple inheritance.md Protocol type non conformance protocol type non conformance.md Opaque type inference opaque type inference.md Foreign reference type foreign reference type.md Build & Migration Diagnostics Diagnostic Filename Deprecated declaration deprecated declaration.md Error in future Swift version error in future swift version.md Strict language features strict language features.md Strict memory safety strict memory safety.md Implementation only deprecated implementation only deprecated.md Member import visibility member import visibility.md Missing module on known paths missing module on known paths.md Module not testable module not testable.md Module version missing module version missing.md Clang declaration import clang declaration import.md Availability unrecognized name availability unrecognized name.md Always available domain always available domain.md Upcoming language features upcoming language features.md Unknown warning group unknown warning group.md Compilation caching compilation caching.md Embedded restrictions embedded restrictions.md Swift Language Diagnostics Diagnostic Filename Dynamic callable requirements dynamic callable requirements.md Property wrapper requirements property wrapper requirements.md Result builder methods result builder methods.md String interpolation conformance string interpolation conformance.md Trailing closure matching trailing closure matching.md Temporary pointers temporary pointers.md Semantic copies semantic copies.md Performance hints performance hints.md Index Diagnostic Filename Diagnostic groups (taxonomy) diagnostic groups.md All diagnostics index diagnostics.md If a diagnostic you need isn't listed above, list the diagnostics directory first: <Xcode .app is the app session context names; without session context, derive it as above. Command Line Tools keep the same files at /Library/Developer/CommandLineTools/usr/share/doc/swift/diagnostics/ . Filenames follow the diagnostic's short name (lowercase, hyphenated). Routing Decision Tree Fallback When Xcode Is Unavailable If the resolved Xcode has no IDEIntelligenceChat.framework documentation directory (older Xcode, or only Command Line Tools installed), fall back to the list below. For a Swift diagnostic, first try the Command Line Tools copy at /Library/Developer/CommandLineTools/usr/share/doc/swift/diagnostics/ . 1. sosumi.ai (markdown mirror of developer.apple.com — see skills/apple docs research.md ) 2. The SDK's own declarations – its Swift interfaces and Objective C headers (also in skills/apple docs research.md ); Command Line Tools includes only the macOS SDK 3. Suggest installing the latest Xcode for full Apple docs coverage Do not silently fail — tell the user when Xcode docs aren't available locally and which fallback you used. MCP Convenience Path Clients using axiom mcp can also invoke axiom read skill with the legacy ID (e.g., apple guide swiftui implementing liquid glass design ). The MCP server reads the same Xcode files and returns the same content. Both paths are supported — the file Read path works everywhere; the MCP path is a convenience for catalog/search workflows. Research Methodology When the bundled guides don't cover it — Apple's full API reference, the SDK's own declarations, or a WWDC session's transcript and code — see [skills/apple docs research.md](skills/apple docs research.md). Resources Skills : axiom swiftui, axiom concurrency, axiom data, axiom ai, axiom integration