SwiftUI Agent Skill: умный наставник для AI-агентов в iOS-разработке

Что это и для кого

SwiftUI Agent Skill — это агент-скилл, который помогает AI-ассистентам писать более умный, простой и современный SwiftUI-код, включая рекомендации по API, дизайну, производительности и доступности.

Проект создан Paul Hudson — автором ресурса Hacking with Swift, известного в сообществе под ником @twostraws. Он работает со SwiftUI с момента его выхода в 2019 году и со временем начал замечать, что AI-агенты воспроизводят одни и те же ошибки: делают кнопки невидимыми для VoiceOver, используют устаревшее API и пишут код с неожиданными проблемами производительности.

Для кого этот инструмент:

• iOS/macOS-разработчики, использующие AI-агенты (Claude Code, Codex, Gemini, Cursor)
• Команды, внедряющие AI в процесс code review
• Все, кто хочет, чтобы AI генерировал современный SwiftUI-код без «устаревших привычек»

Как это работает

Скилл построен на основе существующего AGENTS.md-файла — это позволяет принести многолетние знания и практический опыт в любой AI-агент буквально за несколько минут. В отличие от обычного CLAUDE.md, при старте сессии загружается только краткое описание скилла, а полное содержимое подтягивается только в момент его вызова — это экономит токены и ускоряет работу агента.

graph LR
    A[Разработчик устанавливает\nSwiftUI Agent Skill] --> B[AI-агент\nзапускается]
    B --> C{Задача связана\nсо SwiftUI?}
    C -- Да --> D[Скилл swiftui-pro\nавтоматически активируется]
    C -- Нет --> E[Обычная работа\nагента]
    D --> F[Проверка по 9 измерениям\nAPI / Перф / A11y / ...]
    F --> G[Отчёт: проблемы\n+ исправления с кодом]

Ключевые возможности

Скилл swiftui-pro помогает AI-ассистентам писать более умный и современный SwiftUI, охватывая навигацию, разметку, анимации, управление состоянием, VoiceOver, устаревшее API и многое другое — нацелено именно на ошибки, которые реально делают LLM.

1. Устаревшее API

Скилл содержит обширные рекомендации по замене устаревших API: избегать foregroundColor(), конкатенации Text с +, и отказываться от ObservableObject там, где это не строго необходимо.

// ❌ Устаревший код (сгенерированный AI без скилла)
Text("Hello")
    .foregroundColor(.red)
+ Text(" World")

// ✅ Современный код (с рекомендациями swiftui-pro)
Text("Hello World")
    .foregroundStyle(.red)

2. Производительность

Скилл даёт советы по производительности: не выполнять View-работу в инициализаторах или body-свойствах, разбивать вьюхи на части, чтобы максимально использовать макрос @Observable.

3. Доступность (Accessibility)

Скилл покрывает распространённые проблемы доступности, включая невидимые для VoiceOver кнопки, Dynamic Type и Reduce Motion — именно те anti-patterns, которые чаще всего встречаются в AI-сгенерированном SwiftUI-коде.

4. Девять измерений проверки

Скилл валидирует код по девяти направлениям:

1. Deprecated APIs
2. View optimization
3. Data flow
4. Navigation
5. Design compliance (HIG)
6. Accessibility (Dynamic Type, VoiceOver, Reduce Motion)
7. Performance
8. Swift Concurrency
9. Code hygiene

5. Частичные проверки

Скилл можно вызвать с конкретными инструкциями для частичного review. Например, /swiftui-pro Check for deprecated API в Claude Code или $swiftui-pro Focus on accessibility в Codex.

Установка

Большинство пользователей могут установить скилл одной командой:

npx skills add https://github.com/twostraws/swiftui-agent-skill --skill swiftui-pro

При установке через npx можно выбрать конкретных агентов (Claude Code, Codex, Gemini, Cursor), а также указать — только для текущего проекта или глобально.

brew install node

Тарифы и цены

SwiftUI Agent Skill доступен под лицензией MIT — бесплатно, без подписок и платных уровней. Лицензия разрешает коммерческое использование, модификацию, распространение и приватное применение. Стоимость использования определяется только вашим AI-агентом (например, тарифом Claude Code или Codex API).

Плюсы и минусы

Сравнение с альтернативами

«Скилл построен на тысячах часов реального изучения, экспериментов и разработки SwiftUI-проектов» — Paul Hudson, README проекта.

Динамика роста

Проект вышел в начале марта 2026 года. Уже в первый день скилл набрал 500 звёзд на GitHub. Спустя неделю после релиза Paul Hudson сообщил, что скилл достиг 1800 звёзд и продолжает расти. По данным GitHub на момент написания обзора репозиторий насчитывает более 5 300 звёзд — это самый популярный Swift agent skill на платформе.

Вердикт

Рейтинг: 9/10

Скилл перехватывает типичные ошибки AI-инструментов: устаревшие модификаторы, проблемы доступности, ловушки производительности — и одной командой установки серьёзно повышает качество AI-сгенерированного SwiftUI-кода. Единственное ограничение — жёсткий фокус на iOS 26+, что делает его неприменимым для поддержки legacy-проектов на более ранних версиях iOS.