apple-docs-index logo

apple-docs-index

apple docs index

SKILL.md

Full skill instructions

Apple Documentation Index

This skill provides indexes of Apple framework documentation. Use these to:

  • Browse available APIs in a framework
  • Find the path to specific documentation
  • Decide what detailed docs to download

Available Indexes

FrameworkFileSizeTopics
SwiftUI../swiftui/swiftui-overview.md907KBViews, modifiers, navigation, state
XCTestxctest-index.md55KBTesting, assertions, expectations
XCUIAutomationxcuiautomation-index.md58KBUI testing, elements, queries
UIKit../uikit/uikit-overview.md1.8MBViews, controllers, controls, scenes
Core Animation../core-animation/core-animation-index.md80KBCALayer, CAAnimation, CATransaction, layer subclasses
HealthKithealthkit-index.md312KBHealth data, workouts, records
Combinecombine-index.md153KBPublishers, subscribers, operators
SwiftDataswiftdata-index.md86KBModels, containers, queries
Observationobservation-index.md3KB@Observable macro

How to Use

1. Browse an Index

# See what's in HealthKit
cat healthkit-index.md | head -100

# Search for specific topic
grep -i "workout" healthkit-index.md
grep -i "navigation" ../swiftui/swiftui-overview.md

2. Find Documentation Paths

Index files list all available documentation pages. Each entry shows the path:

- [HKWorkout](/documentation/healthkit/hkworkout)
- [NavigationStack](/documentation/swiftui/navigationstack)

3. Fetch More Detailed Docs

  1. Check whether the detailed page is already available in one of your installed Apple skills.
  2. Use skill names, descriptions, or SKILL.md frontmatter to find likely skill directories, then grep their local .md files before fetching. This is faster and uses less context than fetching new docs from the internet.
  3. If no installed skill has the page, use the same path with the sosumi.ai Markdown mirror.

For example, /documentation/healthkit/hkworkout maps to https://sosumi.ai/documentation/healthkit/hkworkout.

4. Browse Missing Framework Indexes

If the local indexes don't include the framework you need, use the framework's sosumi.ai index:

https://sosumi.ai/documentation/{framework}

For example, https://sosumi.ai/documentation/foundation provides a Markdown index you can search for Foundation paths.

If the Markdown mirror is unavailable and your environment can parse JSON, Apple's public DocC index endpoint is:

https://developer.apple.com/tutorials/data/index/{framework}

The useful path tree is under interfaceLanguages.swift[0].children.