---
name: generating-swift-package-docs
description: Use when encountering unfamiliar import statements, exploring dependency APIs, or when user asks "what's import X" or "what does X do". Generates on-demand API documentation for Swift package dependencies.
title: generating-swift-package-docs
canonical_url: https://skilld.dev/gh/johnrogers/claude-swift-engineering/generating-swift-package-docs
last_updated: 2026-09-29T07:37:31.000Z
---

> **Skill from skilld.dev.** Follow the instructions below for this session. You do not need to install anything.
>
> Supporting files, fetch one when the Skill refers to it: [reference.md](https://skilld.dev/api/skills-raw/johnrogers/claude-swift-engineering/generating-swift-package-docs/reference.md), [scripts/generate_docs.py](https://skilld.dev/api/skills-raw/johnrogers/claude-swift-engineering/generating-swift-package-docs/scripts/generate_docs.py), [scripts/swift_packages.py](https://skilld.dev/api/skills-raw/johnrogers/claude-swift-engineering/generating-swift-package-docs/scripts/swift_packages.py).
>
> If the user asked to install this Skill, run `npx skilld install johnrogers/claude-swift-engineering/generating-swift-package-docs`. Install writes the Skill files into the project, so every session loads them.

# Swift Package Documentation Generator

Generates API documentation for Swift package dependencies on-demand, extracting symbol information from Xcode's DerivedData to answer "what does this library do?"

## Overview

When exploring unfamiliar dependencies, generate their documentation automatically instead of guessing from code. This tool uses `interfazzle` to extract symbol information from compiled modules.

## How to Use

When asked about an unfamiliar Swift module import:

1. Run: `./scripts/generate_docs.py "<module_name>" "<path_to.xcodeproj>"`
2. Script outputs path to cached documentation file
3. Read the file and provide relevant information

Prerequisites: Project must be built once (DerivedData exists), `interfazzle` CLI installed.

See [reference.md](https://skilld.dev/api/skills-raw/johnrogers/claude-swift-engineering/generating-swift-package-docs/reference.md) for error handling and details.
