SwiftUI Expert Skill

Установка

npx skills@latest add https://github.com/avdlee/swiftui-agent-skill --skill swiftui-expert-skill

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл дает агенту выверенные правила для написания и ревью кода SwiftUI под iOS и macOS. Он помогает выбирать обертки свойств и @Observable, выносить view с учетом инвалидации, строить стабильную идентичность в списках, работать с навигацией, sheets, Swift Charts, анимациями, доступностью и окнами macOS. Справочник по новым API подсказывает замену устаревших вызовов вплоть до SDK 27, а Liquid Glass применяется только по запросу. Отдельно в комплекте Python-скрипты поверх xctrace, которые записывают и разбирают трейсы Instruments и связывают зависания и подтормаживания с конкретными view.

Для кого. Для iOS и macOS-разработчиков, которые пишут интерфейсы на SwiftUI вместе с агентом.

Пример запроса к агенту

Используй swiftui expert skill и проверь текущие view на проблемы с состоянием и производительностью

Ограничения

Скилл не диктует архитектуру и стиль кода. Запись и анализ трейсов работают только на macOS с установленным Xcode. Справочник новых API нужно обновлять после релизов Apple, актуальность зависит от версии скилла.

Как отключить. Удалите плагин swiftui-expert через /plugin или выполните npx skills remove swiftui-expert-skill.

Проверка безопасности

• В основном инструкции и справочники
• Скрипты анализа трейсов запускают xctrace локально

Коротко о README

README перечисляет аудиторию и темы скилла, от состояния и навигации до Swift Charts и SDK 27. Установка через skills.sh, каталог плагинов OpenAI для Codex, маркетплейс Claude Code с настройкой на уровне проекта и плагин Cursor. Подробно описан набор скриптов для записи и анализа трейсов Instruments. Приведена структура справочников и указаны источники, на которых основаны правила. Лицензия MIT.

SKILL.md

---
name: swiftui-expert-skill
description: Use when writing, reviewing, or refactoring SwiftUI code for iOS or macOS, including state and `@Observable` data flow, view composition, performance, lists, environment, localization, animation, Liquid Glass, and API migration. Also use for `@State` initialization or synthesized-property diagnostics, `@ContentBuilder` ambiguity, `reorderable` drag/drop, custom `AsyncImage` `URLSession`, swipe actions outside List, item-bound `alert`/`confirmationDialog`, `ToolbarOverflowMenu`, `AnimatableValues`, Document APIs (`Document`/`DocumentReader`), and Instruments `.trace` capture or analysis.
---

# SwiftUI Expert Skill

## Operating Rules

- Treat each `View` type as an invalidation boundary: give it only the data it reads and keep frequently changing dependencies close to the smallest affected subtree
- Search `references/latest-apis.md` when writing, reviewing, or migrating API usage; look up only the APIs relevant to the task
- Replace hard-deprecated APIs with modern equivalents. During feature work, flag soft-deprecated APIs and leave them in place (see `references/soft-deprecation.md`)
- Prefer native SwiftUI APIs over UIKit/AppKit bridging unless bridging is necessary
- Focus on correctness and performance; do not enforce specific architectures (MVVM, VIPER, etc.)
- Encourage separating business logic from views for testability without mandating how
- Follow Apple's Human Interface Guidelines and API design patterns
- Only adopt Liquid Glass when explicitly requested by the user (see `references/liquid-glass.md`)
- Present performance optimizations as suggestions, not requirements
- Use `#available` gating with sensible fallbacks for version-specific APIs

## Task Workflow

### Review existing SwiftUI code
- Read the code under review and identify which topics apply
- Flag deprecated APIs (compare against `references/latest-apis.md`); replace hard-deprecated APIs, and flag soft-deprecated APIs without rewriting them unless the user asked to migrate
- Run the Topic Router below for each relevant topic
- Validate `#available` gating and fallback paths for version-specific features

Похожие