swiftui-code-review — скилл для Claude Code: проверка SwiftUI
Скилл swiftui-code-review для Claude Code проверяет SwiftUI-код: композицию представлений, состояние, производительность и доступность. Разбирает файлы с @State, @Binding, @Observable и UI-кодом.
Apache-2.0 277 установок ★ 89 обновлён 2026-09-15
npx skills add existential-birds/beagle --skill swiftui-code-review -a claude-codeЧто делает swiftui-code-review
Скилл разбирает структуру view-тел, порядок модификаторов и использование property wrapper'ов (@State, @Binding, @Observable, @Bindable). Проверяет, правильно ли распределены обязанности между @StateObject для объектов, принадлежащих view, и @ObservedObject для переданных извне.
Анализирует производительность: ищет места, где LazyVStack или LazyHStack помогут избежать отрисовки всех элементов сразу, выявляет AnyView (его лучше заменить на @ViewBuilder или дженерики) и неустойчивые ID в ForEach. Проверяет доступность — accessibilityLabel у изображений и иконок, accessibilityAddTraits для кастомных кнопок, поддержку Dynamic Type без фиксированных размеров шрифта.
Каждое замечание привязано к конкретной строке файла. Скилл требует открытых .swift-файлов и перед рекомендацией консультируется с внутренними справочниками по композиции представлений, управлению состоянием, производительности и VoiceOver.
Какие задачи решает
- Упростить сложные view-тела и распределить логику по отдельным компонентам
- Выправить порядок модификаторов, чтобы стили применялись как задумано
- Проверить правильность @State, @Binding и @Observable для конкретной архитектуры
- Оптимизировать списки для быстрой прокрутки больших наборов данных
- Убедиться, что интерфейс доступен для VoiceOver и масштабируется с Dynamic Type
Примеры запросов агенту
- Проверь этот view-контроллер на композицию и управление состоянием
- Распредели модификаторы правильно в файле
ProfileView.swift - Проверь доступность и совместимость с Dynamic Type в этом экране
Как установить swiftui-code-review
1Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill swiftui-code-review -a claude-code2Вручную: положить файлы
~/.claude/skills/swiftui-code-review/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/swiftui-code-review/
1Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill swiftui-code-review -a codex2Вручную: положить файлы
.agents/skills/swiftui-code-review/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill swiftui-code-review -a cursor2Вручную: положить файлы
.cursor/skills/swiftui-code-review/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install existential-birds/beagle plugins/beagle-ios/skills/swiftui-code-review2Вручную: положить файлы
.github/skills/swiftui-code-review/SKILL.md1Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill swiftui-code-review -a gemini-cli2Командой платформы
gemini skills install https://github.com/existential-birds/beagle --path plugins/beagle-ios/skills/swiftui-code-reviewВручную: положить файлы
.devin/skills/swiftui-code-review/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill swiftui-code-review -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о swiftui-code-review
Как установить swiftui-code-review в Claude Code?
Выполни npx skills add existential-birds/beagle --skill swiftui-code-review -a claude-code, затем открой ~/.claude/skills/swiftui-code-review/SKILL.md.
Что проверяет swiftui-code-review?
Композицию view-тел, правильность property wrapper'ов (@State, @Binding, @Observable), производительность списков, порядок модификаторов и доступность через VoiceOver и Dynamic Type.
На каких платформах работает скилл?
Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Для каждой свои команды установки.
Исходный текст
SKILL.md · Apache-2.0
--- name: swiftui-code-review description: Reviews SwiftUI code for view composition, state management, performance, and accessibility. Use when reviewing .swift files containing SwiftUI views, property wrappers (@State, @Binding, @Observable), or UI code. --- # SwiftUI Code Review ## Quick Reference | Issue Type | Reference | |------------|-----------| | View extraction, modifiers, body complexity | [references/view-composition.md](references/view-composition.md) | | @State, @Binding, @Observable, @Bindable | [references/state-management.md](references/state-management.md) | | LazyStacks, AnyView, ForEach, identity | [references/performance.md](references/performance.md) | | VoiceOver, Dynamic Type, labels, traits | [references/accessibility.md](references/accessibility.md) | ## Gates (review workflow) Complete in order; do not skip ahead. 1. **Anchor scope** — Pass when: every reviewed file is listed as a repo-relative `.swift` path (or the review explicitly states “none opened / N/A” with reason). 2. **Reference before critique** — Pass when: for any non-trivial body, modifier chain, or wrapper-ownership question, you have opened the matching `references/*.md` row from the table above *or* you state “not needed” with one line why. 3. **Evidence-bound findings** — Pass when: each substantive issue includes **`[FILE:LINE]`** (or a bounded line range) before recommendations; symbols/snippets may supplement but not replace the location anchor; no finding that rests only on “typical SwiftUI” without pointing at this code. ## Review Checklist - [ ] View body under 10 composed elements (extract subviews) - [ ] Modifiers in correct order (padding before background) - [ ] @StateObject for view-owned objects, @ObservedObject for passed objects - [ ] @Bindable used for two-way bindings to @Observable (iOS 17+) - [ ] LazyVStack/LazyHStack for scrolling lists with 50+ items - [ ] No AnyView (use @ViewBuilder or generics instead) - [ ] ForEach uses stable Identifiable IDs (not array indices) - [ ] All images/icons have accessibilityLabel - [ ] Custom controls have accessibilityAddTraits(.isButton) - [ ] Dynamic Type supported (no fixed font sizes) - [ ] .task modifier for async work (not onAppear + Task) ## When to Load References - Complex view bodies or modifier chains -> view-composition.md - Property wrapper usage (@State, @Observable) -> state-management.md - List performance or view identity issues -> performance.md - VoiceOver or accessibility implementation -> accessibility.md ## Review Questions 1. Could this large view body be split into smaller, reusable Views? 2. Is modifier order intentional? (padding -> background -> frame) 3. Is @StateObject/@ObservedObject usage correct for ownership? 4. Could LazyVStack improve this ScrollView's performance? 5. Would VoiceOver users understand this interface?
© existential-birds · Apache-2.0 · existential-birds/beagle