generating-swift-package-docs — скилл Claude Code: обзор и установка
Скилл generating-swift-package-docs генерирует справочную документацию по Swift-пакетам прямо из DerivedData проекта при анализе незнакомых библиотек.
MIT ★ 233 обновлён 2026-01-18
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineeringЧто делает generating-swift-package-docs
Скилл помогает разбираться с незнакомыми зависимостями в кодовой базе на Swift. Когда в файле встречается непонятный import или возникает вопрос о возможностях конкретного модуля, ассистент не гадает по чужому коду, а формирует точную документацию по API.
Внутри работает скрипт ./scripts/generate_docs.py "<module_name>" "<path_to.xcodeproj>". Он извлекает описания символов из скомпилированных бинарников через утилиту interfazzle, сохраняет результат в кеш и читает готовый файл с выжимкой.
Без предварительной сборки проекта в Xcode генерация не сработает: утилите нужен каталог DerivedData и установленный CLI-инструмент interfazzle.
Какие задачи решает
- разобрать назначение незнакомого импорта в файле Swift
- исследовать публичный API стороннего пакета без поиска в браузере
- извлечь описания символов модуля напрямую из DerivedData
Примеры запросов агенту
- Что делает импорт
import Alamofireв этом проекте? - Объясни назначение библиотеки
KeychainAccessдля проектаMyApp.xcodeproj - Сгенерируй документацию по публичным методам модуля
Swinject
Как установить generating-swift-package-docs
1Через маркетплейс плагинов
/plugin marketplace add johnrogers/claude-swift-engineering/plugin install swift-engineering@claude-swift-engineeringКоманда ставит плагин swift-engineering целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill generating-swift-package-docs -a claude-code3Вручную: положить файлы
~/.claude/skills/generating-swift-package-docs/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/generating-swift-package-docs/
1Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill generating-swift-package-docs -a codex2Вручную: положить файлы
.agents/skills/generating-swift-package-docs/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill generating-swift-package-docs -a cursor2Вручную: положить файлы
.cursor/skills/generating-swift-package-docs/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install johnrogers/claude-swift-engineering plugins/swift-engineering/skills/generating-swift-package-docs2Вручную: положить файлы
.github/skills/generating-swift-package-docs/SKILL.md1Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill generating-swift-package-docs -a gemini-cli2Командой платформы
gemini skills install https://github.com/johnrogers/claude-swift-engineering --path plugins/swift-engineering/skills/generating-swift-package-docsВручную: положить файлы
.devin/skills/generating-swift-package-docs/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о generating-swift-package-docs
Как установить generating-swift-package-docs в Claude Code?
Выполните в терминале команду npx skills add johnrogers/claude-swift-engineering --skill generating-swift-package-docs -a claude-code или добавьте каталог маркетплейса /plugin marketplace add johnrogers/claude-swift-engineering и установите плагин /plugin install swift-engineering@claude-swift-engineering.
Что делает generating-swift-package-docs?
Скилл запускает скрипт генерации API-документации для подключённых Swift-библиотек, читая метаданные скомпилированных модулей.
Что требуется подготовить для корректной работы скилла?
Проект в Xcode нужно собрать хотя бы один раз, чтобы сгенерировалась папка DerivedData, а в системе должен быть установлен CLI-инструмент interfazzle.
Исходный текст
SKILL.md · MIT
--- 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. --- # 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](reference.md) for error handling and details.
© John Rogers (@johnrogers) · MIT · johnrogers/claude-swift-engineering