explore-apple-swift-docs

Explore Apple and Swift documentation across Xcode MCP, Dash, and web sources.

9|1|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/gaelic-ghost/apple-dev-skills --skill explore-apple-swift-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: explore-apple-swift-docs
Source: https://github.com/gaelic-ghost/apple-dev-skills/tree/main/skills/explore-apple-swift-docs
Command: npx skills add https://github.com/gaelic-ghost/apple-dev-skills --skill explore-apple-swift-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires PyYAML, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill centralizes Apple and Swift documentation discovery so agents and maintainers can reliably find authoritative API references, guides, and symbol pages without guessing which local or web source to use. It reduces time spent switching between Xcode MCP, Dash, and web docs by applying a documented selection and fallback order and by providing clear next steps when local coverage is missing.

Core Features & Use Cases

  • Multi-source discovery: Prefer Xcode MCP, then Dash MCP, then Dash localhost HTTP, then official Apple/Swift web docs, with optional user preference override.
  • Dash follow-up modes: Support dash-install and dash-generate flows with catalog matching, approval gating, and machine-readable install guidance.
  • Maintainer helpers and probes: Includes scripts to probe Dash, refresh or match Dash catalogs, and run guarded install or generate helpers useful for dry runs and automation.
  • Use case: Quickly locate a Swift symbol's authoritative documentation, suggest a docset install if missing, and hand off to generation guidance when no installable docset exists.

Quick Start

Ask the skill to explore the query "URLSession data task" with mode explore and preferred_source auto to receive source_used, matches, and a recommended next step.

Frequently Asked Questions about explore-apple-swift-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search Apple Swift documentation across local and web sources?

You can search Apple Swift documentation by applying a fallback order across Xcode MCP, Dash, Dash localhost HTTP, and official web docs to find authoritative API references, symbols, and guides.

What is the best way to look up Swift API references when offline?

For offline Swift API reference lookups, the discovery workflow prefers Xcode MCP first, then falls back to Dash and Dash localhost HTTP before checking official web docs.

How do I install missing Dash docsets for SwiftUI frameworks?

You can install missing Dash docsets by triggering the dash-install flow, which matches catalog entries, enforces approval gating, and returns machine-readable install guidance for SwiftUI frameworks.

Can I generate Dash docsets when no installable Apple docset exists?

Yes, when no installable Dash docset exists for Apple frameworks, the workflow hands off to dash-generate guidance to help you create the required local documentation.

Does this documentation search workflow integrate with Xcode MCP?

Yes, the workflow integrates with Xcode MCP by selecting it as the primary source for Swift symbol and topic searches, falling back to Dash and web docs only when local coverage is missing.

What should I do if a Swift symbol search returns no local matches in Dash?

If a Swift symbol search returns no local Dash matches, the workflow suggests a docset install or hands off to generation guidance, then queries official Apple web docs as a final fallback.