generating-swift-package-docs

v2026.09.24

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.

GitHub
Install command
npx skhub add johnrogers/generating-swift-package-docs
Markdown
SKILL.md

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 for error handling and details.

Discovery
Tags

No tags published for this skill.

Version
Latest version metadata

Version

v2026.09.24

Published

Sep 24, 2026

Category

Uncategorized

License

MIT

Source path

plugins/swift-engineering/skills/generating-swift-package-docs

Default branch

main

Latest commit

1dc2cf4

Tree SHA

01f1dca