@johnrogers/generating-swift-package-docs

A collection of agents and skills to aid in the planning, implementation, documentation and testing of Swift/TCA code.

View in AI SkillSafe app
960 downloads
0 stars
0 demos
SKILL.md
namegenerating-swift-package-docs
descriptionUse 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.

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.

Embed badges

Add these to your README to show the skill's verification status.

SkillSafe verified badge
Verified badge
[![SkillSafe verified badge](https://api.skillsafe.ai/v1/badge/@johnrogers/generating-swift-package-docs/verified)](https://skillsafe.ai/skill/@johnrogers/generating-swift-package-docs/)
Installs badge
Installs badge
[![Installs badge](https://api.skillsafe.ai/v1/badge/@johnrogers/generating-swift-package-docs/installs)](https://skillsafe.ai/skill/@johnrogers/generating-swift-package-docs/)
Scan badge
Scan badge
[![Scan badge](https://api.skillsafe.ai/v1/badge/@johnrogers/generating-swift-package-docs/scan)](https://skillsafe.ai/skill/@johnrogers/generating-swift-package-docs/)
Eval pass rate badge
Eval pass rate
[![Eval pass rate badge](https://api.skillsafe.ai/v1/badge/@johnrogers/generating-swift-package-docs/eval)](https://skillsafe.ai/skill/@johnrogers/generating-swift-package-docs/)