generating-swift-package-docs

Generate Markdown API documentation for Swift package dependencies.

223|21|Updated Dec 20, 2025
One-click install
npx skills add https://github.com/johnrogers/claude-swift-engineering --skill generating-swift-package-docs-johnrogers
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: generating-swift-package-docs
Source: https://github.com/johnrogers/claude-swift-engineering/tree/main/plugins/swift-engineering/skills/generating-swift-package-docs
Command: npx skills add https://github.com/johnrogers/claude-swift-engineering --skill generating-swift-package-docs-johnrogers

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

The Swift Package Documentation Generator creates on-demand API docs for Swift package dependencies when encountering unfamiliar imports or APIs in a project, saving time and guesswork.

Core Features & Use Cases

  • Automatically generates Markdown API docs for Swift packages found in a project's dependencies.
  • Caches generated documentation per major.minor version and concatenates package READMEs when available.
  • Integrates with Xcode DerivedData via interfazzle to extract symbol surfaces and provide quick references during development.

Quick Start

Provide a module name and your Xcode project path to generate documentation for its dependencies.

Frequently Asked Questions about generating-swift-package-docs

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

FAQPage Schema
How do I generate Swift package API documentation for dependencies in my Xcode project?

To generate Swift package API documentation, provide a module name and your Xcode project path. The tool extracts symbol surfaces from Package.resolved and DerivedData to produce consolidated Markdown references for your dependencies.

How does Swift package documentation extraction work with Xcode DerivedData?

Swift package documentation extraction uses the interfazzle CLI to parse DerivedData and Package.resolved files. It locates compiled package modules, extracts public symbol interfaces, and converts them into readable Markdown documentation.

Do I need Python and interfazzle to generate Swift package markdown docs?

Yes, generating Swift package markdown docs requires Python 3 and the interfazzle CLI. These dependencies interface with Xcode DerivedData to extract symbol surfaces and parse your project's Package.resolved file for dependency information.

Can I automatically document unfamiliar Swift module imports during development?

Yes, you can automatically document unfamiliar Swift module imports by running the generator during coding sessions. It extracts public API surfaces from package dependencies and caches the markdown docs per major.minor version for quick reference.

What is the best way to explore unfamiliar Swift package APIs without leaving my coding environment?

The best way to explore unfamiliar Swift package APIs is generating on-demand Markdown documentation from DerivedData. This caches package interfaces per version, concatenates available READMEs, and provides quick references for planning and code-writing tasks.

Are there limitations when generating documentation for Swift package dependencies?

Documentation generation relies on Xcode DerivedData and Package.resolved files, requiring a successfully built project. It caches docs per major.minor version and concatenates READMEs when available, but cannot extract symbols for packages that have not been compiled locally.