swift-api-design-guidelines — скилл для Claude Code
Скилл помогает оформлять публичные интерфейсы на Swift по официальным гайдлайнам Apple. Пригодится при выборе меток аргументов, пар мутирующих методов и написании документации.
npx skills add dpearson2699/swift-ios-skills --skill swift-api-design-guidelines -a claude-codeЧто делает swift-api-design-guidelines
Скилл систематизирует правила именования функций и параметров в Swift. Он объясняет, когда опускать первый аргумент метода, как вплетать предлоги в сигнатуры и почему мутирующие варианты операций требуют глаголов повелительного наклонения вроде sort(), а немутирующие — причастий вроде sorted().
Отдельный блок правил регулирует комментирование кода. Каждое публичное объявление описывается кратким предложением с указанием параметров, возвращаемых ошибок и вычислительной сложности. Вычисляемые свойства считаются работающими за O(1) по умолчанию, поэтому скилл требует явно указывать сложность для любых свойств с более тяжёлыми вычислениями.
Инструмент строго сфокусирован на сигнатурах и ясности места вызова. Вопросы многопоточности, работы с типами или настройки правил линтера он направляет в специализированные скиллы swift-concurrency, swift-language и swiftlint.
Какие задачи решает
- подобрать понятные метки аргументов по правилам грамматических конструкций
- правильно назвать пару мутирующего и немутирующего метода
- оформить документационные комментарии с разметкой параметров и ошибок
- указать вычислительную сложность для нестандартных вычисляемых свойств
Примеры запросов агенту
- Проверь метод
remove(at index: Int)на соответствие Swift API Design Guidelines. - Как назвать немутирующий аналог для метода
append(_ element: Element)? - Напиши документационный комментарий для свойства со сложностью O(n).
Как установить swift-api-design-guidelines
1Через Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill swift-api-design-guidelines -a claude-code2Вручную: положить файлы
~/.claude/skills/swift-api-design-guidelines/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/swift-api-design-guidelines/
1Через Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill swift-api-design-guidelines -a codex2Вручную: положить файлы
.agents/skills/swift-api-design-guidelines/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill swift-api-design-guidelines -a cursor2Вручную: положить файлы
.cursor/skills/swift-api-design-guidelines/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install dpearson2699/swift-ios-skills swift-api-design-guidelines2Вручную: положить файлы
.github/skills/swift-api-design-guidelines/SKILL.md1Через Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill swift-api-design-guidelines -a gemini-cli2Командой платформы
gemini skills install https://github.com/dpearson2699/swift-ios-skills --path skills/swift-api-design-guidelinesВручную: положить файлы
.devin/skills/swift-api-design-guidelines/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill swift-api-design-guidelines -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о swift-api-design-guidelines
Как установить swift-api-design-guidelines в Claude Code?
Выполните команду npx skills add dpearson2699/swift-ios-skills --skill swift-api-design-guidelines -a claude-code.
Что делает скилл swift-api-design-guidelines?
Он проверяет интерфейсы Swift на ясность в месте вызова. Скилл помогает выбрать имена функций, расставить метки аргументов и оформить комментарии по канонам Swift.
Подходит ли скилл для настройки правил SwiftLint или многопоточного кода?
Нет, он отвечает исключительно за дизайн API и форму сигнатур. Задачи по многопоточности перенаправляются в swift-concurrency, а параметры линтера настраиваются через swiftlint.
