axiom-apple-docs

Name: axiom-apple-docs
Author: charleswiltgen

github.com/charleswiltgenDevelopment1.2k1.5k installsUpdated today

About axiom-apple-docs

axiom-apple-docs guides developers to Apple’s Markdown documentation and Swift compiler diagnostics bundled with Xcode. It is intended for API, framework, and compiler-error research, with fallback sources when local Xcode documentation is unavailable.

Key features

01Routes to official Xcode documentation
02Indexes Swift compiler diagnostics
03Finds framework guides by topic
04Provides fallbacks when Xcode docs are absent

Use cases

01Verify an Apple API signature or behavior
02Understand a Swift compiler diagnostic
03Locate an official guide for a framework
04Continue research without local Xcode documentation

MCP support

The README notes that axiom-mcp can use axiom_read_skill to retrieve the same Xcode files as a convenience alongside direct file reading.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/charleswiltgen/axiom --skill axiom-apple-docs

After installing, type/axiom-apple-docsin Claude Code to confirm it loaded.

Bundled filesskills/apple-docs-research.md

Details

From the project README

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:

Read /Applications/Xcode.app/Contents/PlugIns/IDEIntelligenceChat.framework/Versions/A/Resources/AdditionalDocumentation/SwiftUI-Implementing-Liquid-Glass-Design.md

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

46 files in the diagnostics directory. 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:

ls "<Xcode>.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/share/doc/swift/diagnostics/"

<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

User question about Apple API/framework?
├── Specific compiler error/warning → Read {diagnostics base}/<diagnostic-name>.md
├── Liquid Glass implementation     → Read {guides base}/<Framework>-Implementing-Liquid-Glass-Design.md
├── Swift concurrency patterns      → Read {guides base}/Swift-Concurrency-Updates.md
├── Foundation Models / on-device AI → Read {guides base}/FoundationModels-Using-on-device-LLM-in-your-app.md
├── SwiftData features              → Read {guides base}/SwiftData-Class-Inheritance.md
├── StoreKit / IAP                  → Read {guides base}/StoreKit-Updates.md
├── App Intents / Siri              → Read {guides base}/AppIntents-Updates.md
├── Charts / visualization          → Read {guides base}/Swift-Charts-3D-Visualization.md
├── Text editing / AttributedString → Read {guides base}/SwiftUI-Styled-Text-Editing.md or Foundation-AttributedString-Updates.md
├── WebKit in SwiftUI               → Read {guides base}/SwiftUI-WebKit-Integration.md
├── Toolbar features                → Read {guides base}/SwiftUI-New-Toolbar-Features.md
└── Other                           → ls the base directory to see what's available

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/.

sosumi.ai (markdown mirror of developer.apple.com — see skills/apple-docs-research.md)
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
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.

Resources

Skills: axiom-swiftui, axiom-concurrency, axiom-data, axiom-ai, axiom-integration

Comments

Markdown supported

Details

Author: charleswiltgen
Repository: charleswiltgen/axiom
Category: Development
Installs: 1,525
GitHub stars: 1,231

Report

More skills

All skills

remotion-render

github.com/inference-sh

1.6M

Render videos from React/Remotion component code via inference.sh. Pass TSX code, get MP4. Supports all Remotion APIs: useCurrentFrame, useVideoConfig, spring, interpolate, AbsoluteFill, Sequence. Configurable resolution, FPS, duration, codec. Use for: programmatic video generation, animated graphics, motion design, data-driven videos, React animations to video. Triggers: remotion, render video from code, tsx to video, react video, programmatic video, remotion render, code to video, animated video, motion graphics code, react animation video

improve-codebase-architecture

github.com/mattpocock

1.2M

Scan a codebase for architecture improvement opportunities, present them as a visual HTML report, then dive deep into whichever one you pick.

design-mobile-apps

github.com/designed-by-ai

1.1M

Design mobile app screens with Sleek, edit Sleek projects, and implement their designs in React Native or HTML

vercel-react-best-practices

github.com/vercel-labs

848.6k

React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.