home / skills / derklinke / codex-config / ios-apple-docs

ios-apple-docs skill

/skills/ios-apple-docs

This skill helps you locate official Apple API signatures and Swift diagnostics by consulting Apple documentation alongside iOS Skill Pack guidance.

npx playbooks add skill derklinke/codex-config --skill ios-apple-docs

Review the files below or copy the command above to add this skill to your agents.

Files (1)

SKILL.md

6.9 KB

---
name: ios-apple-docs
description: 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.
license: MIT
---

# Apple Documentation Router

Apple bundles for-LLM markdown documentation inside Xcode. These are authoritative, up-to-date guides and diagnostics written by Apple engineers. Use them alongside iOS Skill Pack skills for the most accurate information.

## When to Use

Use Apple's bundled docs when:
- You need the exact API signature or behavior from Apple
- iOS Skill Pack skills reference 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**: iOS Skill Pack skills provide opinionated guidance (decision trees, anti-patterns, pressure scenarios). Apple docs provide authoritative API details. Use both together.

## Guide Topics (AdditionalDocumentation)

Read these with the MCP skill-reading tool using the skill name.

### UI & Design

| Topic | Skill Name |
|-------|-----------|
| Liquid Glass in SwiftUI | `apple-guide-swiftui-implementing-liquid-glass-design` |
| Liquid Glass in UIKit | `apple-guide-uikit-implementing-liquid-glass-design` |
| Liquid Glass in AppKit | `apple-guide-appkit-implementing-liquid-glass-design` |
| Liquid Glass in WidgetKit | `apple-guide-widgetkit-implementing-liquid-glass-design` |
| SwiftUI toolbar features | `apple-guide-swiftui-new-toolbar-features` |
| SwiftUI styled text editing | `apple-guide-swiftui-styled-text-editing` |
| SwiftUI WebKit integration | `apple-guide-swiftui-webkit-integration` |
| SwiftUI AlarmKit integration | `apple-guide-swiftui-alarmkit-integration` |
| Swift Charts 3D visualization | `apple-guide-swift-charts-3d-visualization` |
| Foundation AttributedString | `apple-guide-foundation-attributedstring-updates` |

### Data & Persistence

| Topic | Skill Name |
|-------|-----------|
| SwiftData class inheritance | `apple-guide-swiftdata-class-inheritance` |

### Concurrency & Performance

| Topic | Skill Name |
|-------|-----------|
| Swift concurrency updates | `apple-guide-swift-concurrency-updates` |
| InlineArray and Span | `apple-guide-swift-inlinearray-span` |

### Apple Intelligence

| Topic | Skill Name |
|-------|-----------|
| Foundation Models (on-device LLM) | `apple-guide-foundationmodels-using-on-device-llm-in-your-app` |

### System Integration

| Topic | Skill Name |
|-------|-----------|
| App Intents updates | `apple-guide-appintents-updates` |
| StoreKit updates | `apple-guide-storekit-updates` |
| MapKit GeoToolbox | `apple-guide-mapkit-geotoolbox-placedescriptors` |
| Widgets for visionOS | `apple-guide-widgets-for-visionos` |

### Accessibility

| Topic | Skill Name |
|-------|-----------|
| Assistive Access in iOS | `apple-guide-implementing-assistive-access-in-ios` |

### Computer Vision

| Topic | Skill Name |
|-------|-----------|
| Visual Intelligence in iOS | `apple-guide-implementing-visual-intelligence-in-ios` |

## Swift Compiler Diagnostics

These explain specific Swift compiler errors and warnings with examples and fixes.

### Concurrency Diagnostics

| Diagnostic | Skill Name |
|-----------|-----------|
| Actor-isolated call from nonisolated context | `apple-diag-actor-isolated-call` |
| Conformance isolation | `apple-diag-conformance-isolation` |
| Isolated conformances | `apple-diag-isolated-conformances` |
| Nonisolated nonsending by default | `apple-diag-nonisolated-nonsending-by-default` |
| Sendable closure captures | `apple-diag-sendable-closure-captures` |
| Sendable metatypes | `apple-diag-sendable-metatypes` |
| Sending closure risks data race | `apple-diag-sending-closure-risks-data-race` |
| Sending risks data race | `apple-diag-sending-risks-data-race` |
| Mutable global variable | `apple-diag-mutable-global-variable` |
| Preconcurrency import | `apple-diag-preconcurrency-import` |

### Type System Diagnostics

| Diagnostic | Skill Name |
|-----------|-----------|
| Existential any | `apple-diag-existential-any` |
| Existential member access limitations | `apple-diag-existential-member-access-limitations` |
| Nominal types | `apple-diag-nominal-types` |
| Multiple inheritance | `apple-diag-multiple-inheritance` |
| Protocol type non-conformance | `apple-diag-protocol-type-non-conformance` |
| Opaque type inference | `apple-diag-opaque-type-inference` |

### Build & Migration Diagnostics

| Diagnostic | Skill Name |
|-----------|-----------|
| Deprecated declaration | `apple-diag-deprecated-declaration` |
| Error in future Swift version | `apple-diag-error-in-future-swift-version` |
| Strict language features | `apple-diag-strict-language-features` |
| Strict memory safety | `apple-diag-strict-memory-safety` |
| Implementation only deprecated | `apple-diag-implementation-only-deprecated` |
| Member import visibility | `apple-diag-member-import-visibility` |
| Missing module on known paths | `apple-diag-missing-module-on-known-paths` |
| Clang declaration import | `apple-diag-clang-declaration-import` |
| Availability unrecognized name | `apple-diag-availability-unrecognized-name` |
| Unknown warning group | `apple-diag-unknown-warning-group` |

### Swift Language Diagnostics

| Diagnostic | Skill Name |
|-----------|-----------|
| Dynamic callable requirements | `apple-diag-dynamic-callable-requirements` |
| Property wrapper requirements | `apple-diag-property-wrapper-requirements` |
| Result builder methods | `apple-diag-result-builder-methods` |
| String interpolation conformance | `apple-diag-string-interpolation-conformance` |
| Trailing closure matching | `apple-diag-trailing-closure-matching` |
| Temporary pointers | `apple-diag-temporary-pointers` |

## Routing Decision Tree

```
User question about Apple API/framework?
├── Specific compiler error/warning → Read matching apple-diag-* skill
├── Liquid Glass implementation → Read apple-guide-*-liquid-glass-design (SwiftUI/UIKit/AppKit)
├── Swift concurrency patterns → Read apple-guide-swift-concurrency-updates
├── Foundation Models / on-device AI → Read apple-guide-foundationmodels-*
├── SwiftData features → Read apple-guide-swiftdata-*
├── StoreKit / IAP → Read apple-guide-storekit-updates
├── App Intents / Siri → Read apple-guide-appintents-updates
├── Charts / visualization → Read apple-guide-swift-charts-3d-visualization
├── Text editing / AttributedString → Read apple-guide-swiftui-styled-text-editing or apple-guide-foundation-attributedstring-updates
├── WebKit in SwiftUI → Read apple-guide-swiftui-webkit-integration
├── Toolbar features → Read apple-guide-swiftui-new-toolbar-features
└── Other → Search available skills with source filter "apple"
```

## Resources

**Skills**: ios-ios-ui, ios-ios-concurrency, ios-ios-data, ios-ios-ai, ios-ios-integration

Overview

This skill provides direct access to Apple-bundled Xcode documentation for framework APIs, Swift compiler diagnostics, and official guides like Liquid Glass and Foundation Models. It routes questions to the precise Apple doc or diagnostic entry you need and complements opinionated iOS Skill Pack advice with authoritative API details. Use it when you want canonical explanations, exact signatures, or Apple-written migration and diagnostic guidance.

How this skill works

When a question involves an Apple framework API, a Swift compiler error/warning, or an Xcode-bundled guide, this skill selects the matching Apple documentation skill and returns the authoritative content. It follows a decision tree: map the user intent to a guide (UI, concurrency, data, etc.) or a specific diagnostic skill, then surface the official explanation, examples, and recommended fixes. Use it alongside iOS Skill Pack suggestions for practical patterns and trade-offs.

When to use it

You need the exact Apple API signature, availability, or behavior.
A Swift compiler diagnostic needs a canonical explanation and example fixes.
You’re implementing Apple-defined features like Liquid Glass, SwiftData, or Foundation Models.
You want Apple’s official migration notes or deprecation guidance.
You need Xcode-bundled how-to content for UIKit/SwiftUI/AppKit/WidgetKit integration.

Best practices

Ask which specific API, class, or diagnostic you’re seeing to route to the exact doc.
Provide the compiler error text or code snippet when requesting diagnostic guidance.
Combine Apple docs (authoritative details) with iOS Skill Pack guidance for design patterns and trade-offs.
Prefer the skill’s diagnostic entries for Swift concurrency and type-system errors to avoid misdiagnosis.
Use the skill names (e.g., apple-diag-*, apple-guide-*) when requesting a direct doc read for speed.

Example use cases

Explain a Swift compiler error like "actor-isolated call from nonisolated context" with examples and fixes.
Show official API signatures and availability for a Foundation or UIKit type before implementation.
Read Apple’s Liquid Glass guidance for SwiftUI and supply code patterns that match the spec.
Get the on-device Foundation Models guide when adding on-device LLM capabilities to an app.
Retrieve StoreKit or App Intents updates for implementing purchases or voice shortcuts.

FAQ

Does this skill replace community guidance?

No. It provides authoritative Apple docs; combine them with opinionated iOS Skill Pack guidance for practical patterns and trade-offs.

What if I only have an error message?

Provide the exact compiler error/warning text or code snippet and the skill will route to the matching apple-diag-* diagnostic entry with examples and fixes.

Can I request a specific guide by name?

Yes. Provide the apple-guide-* or apple-diag-* skill name to read that exact Xcode-bundled document quickly.