All skills
johnrogers avatar

/generating-swift-package-docs

@798c536

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.

Use this Skill: https://skilld.dev/gh/johnrogers/claude-swift-engineering/generating-swift-package-docs

This session only. Nothing lands on disk.

SKILL.md

≈59 tokens always: the name and description. ≈205 when used: this file. ≈960 more on demand in 1 file.

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.

Source: SKILL.md on GitHub

No alerts16d5 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    The skill generates documentation for Swift packages by reading project metadata and executing external CLI tools. It presents a low risk of indirect prompt injection as it processes untrusted README files and code from external dependencies without sanitization.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: LOW · No issues

  • Runlayer7mo

    4 files scanned · No issues

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at 798c536. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 months ago.

Dormantupdated 9 months ago

README badge

README badge for johnrogers/claude-swift-engineering/generating-swift-package-docs