К основному содержанию
скилл CX Codex

ios-ui-refactor — скилл для Claude Code: аудит SwiftUI

Скилл ios-ui-refactor для Claude Code проверяет существующие SwiftUI-экраны и предлагает рефакторинг визуальной иерархии, переходов и анимаций. Для работы нужны iOS 26 и Swift 6.2.

MIT 299 установок ★ 227 обновлён 2026-08-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add pproenca/dot-skills --skill ios-ui-refactor -a claude-code
Открыть на GitHub

Что делает ios-ui-refactor

ios-ui-refactor даёт линзу для ревью уже готовых SwiftUI-экранов. Он помогает находить лишние элементы, неясные подписи, слабую иерархию, неуместные анимации, несогласованные отступы, радиусы и цвета. Правила собраны по категориям: от сокращения интерфейса и понятности до системности, доступности деталей и доработки после итераций.

Скилл учитывает clinic-модульную архитектуру MVVM-C. Feature-модули должны зависеть от Domain и DesignSystem, а Data и соседние feature-модули для них закрыты. Domain хранит чистые Swift-контракты, Data отвечает за SwiftData, сеть и синхронизацию, а App связывает контейнер зависимостей и координаторы.

Он предназначен для аудита и улучшения существующих экранов, а не для создания интерфейса с нуля. Для нового UI в исходном описании отдельно выделены ios-design, для HIG-проверок — ios-hig, для рефакторинга кода — swift-refactor. Без соблюдения границ clinic-архитектуры рекомендации могут конфликтовать со структурой проекта.

Какие задачи решает

  • проверить иерархию элементов на SwiftUI-экране
  • убрать лишние контролы и декоративные анимации
  • согласовать цвета, отступы и радиусы интерфейса
  • проверить состояния, контраст и тёмную тему
  • аудировать переходы и обработку краевых случаев

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

  • Проверь экран AppointmentView.swift и перечисли нарушения визуальной иерархии.
  • Предложи рефакторинг переходов и анимаций в существующем SwiftUI-экране по правилам ios-ui-refactor.
  • Сверь этот feature-модуль с границами Domain, Data, App и покажи места конфликта.

Как установить ios-ui-refactor

1Через Skills CLI (Vercel)

npx skills add pproenca/dot-skills --skill ios-ui-refactor -a claude-code

2Вручную: положить файлы

~/.claude/skills/ios-ui-refactor/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/ios-ui-refactor/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об ios-ui-refactor

Как установить ios-ui-refactor в Claude Code?

Выполните npx skills add pproenca/dot-skills --skill ios-ui-refactor -a claude-code, затем проверьте файл ~/.claude/skills/ios-ui-refactor/SKILL.md.

Что делает ios-ui-refactor?

Скилл проверяет существующие SwiftUI-интерфейсы и подсказывает, как исправить визуальные анти-паттерны, навигацию, анимации, состояния и дизайн-систему. Он ориентирован на iOS 26 и Swift 6.2.

Чем ios-ui-refactor отличается от ios-design?

ios-ui-refactor анализирует и улучшает уже существующие экраны. ios-design предназначен для создания нового UI, а при пересечении правил ios-ui-refactor использует более подробные преобразования «неверно → верно».

Исходный текст

SKILL.md · MIT
---
name: ios-ui-refactor
description: Principal-level SwiftUI UI review and refactoring patterns for iOS 26 / Swift 6.2 clinic-architecture apps, grounded in Rams, Segall, and Edson principles. Use when auditing or improving existing SwiftUI screens, transitions, animations, and visual systems while preserving brand identity and respecting clinic Domain/Data/App boundaries.
---

# Apple HIG SwiftUI iOS 26 / Swift 6.2 Best Practices

A principal designer's lens for evaluating and refactoring SwiftUI interfaces to Apple-quality standards, grounded in Rams, Segall, and Edson. Contains 51 rules across 8 categories, each grounded in specific principles from three foundational design texts:

- **Dieter Rams** — *Ten Principles for Good Design* ("less, but better," "design should be honest")
- **Ken Segall** — *Insanely Simple* (simplicity as a core principle for intuitive, beautiful products)
- **John Edson** — *Design Like Apple* (design-focused culture, prototyping to perfection, the product is the marketing)

Categories are ordered by a visual review process: start with what to remove, then what to clarify, then what to make honest, invisible, systematic, thorough, enduring, and finally what to refine.

## Scope & Relationship to Sibling Skills

This skill is the **refactoring and review lens** — it evaluates existing UI and identifies visual anti-patterns to fix. When loaded alongside `ios-design` (building new UI), `ios-hig` (HIG compliance), or `swift-refactor` (code-level refactoring), this skill supersedes overlapping rules with more detailed "incorrect -> correct" transformations and "When NOT to apply" guidance. Use this skill for auditing and improving existing screens; use the siblings for greenfield implementation.


## Clinic Architecture Contract (iOS 26 / Swift 6.2)

All guidance in this skill assumes the clinic modular MVVM-C architecture:

- Feature modules import `Domain` + `DesignSystem` only (never `Data`, never sibling features)
- App target is the convergence point and owns `DependencyContainer`, concrete coordinators, and Route Shell wiring
- `Domain` stays pure Swift and defines models plus repository, `*Coordinating`, `ErrorRouting`, and `AppError` contracts
- `Data` owns SwiftData/network/sync/retry/background I/O and implements Domain protocols
- Read/write flow defaults to stale-while-revalidate reads and optimistic queued writes
- ViewModels call repository protocols directly (no default use-case/interactor layer)

## When to Apply

Reference these guidelines when:
- Reviewing existing SwiftUI screens for visual quality issues
- Auditing whether every element on screen earns its place (Rams #10)
- Evaluating if the interface is self-explanatory without tooltips (Rams #4)
- Checking that colors, states, and hierarchy tell the truth (Rams #6)
- Ensuring animations and materials are invisible, not decorative (Rams #5)
- Verifying spacing, radii, and colors form a coherent system (Edson "Systems Thinking")
- Confirming edge cases — reduce motion, touch targets, safe areas — are handled (Rams #8)
- Adopting iOS 26 / Swift 6.2 APIs that refine previously impossible interactions (Edson "Design Out Loud")

## Rule Categories by Priority

| Priority | Category | Principle | Impact | Prefix | Rules |
|----------|----------|-----------|--------|--------|-------|
| 1 | Less, But Better | Rams #10 + Segall "Think Minimal" | CRITICAL | `less-` | 7 |
| 2 | Self-Evident Design | Rams #4 + Segall "Think Human" | CRITICAL | `evident-` | 6 |
| 3 | Honest Interfaces | Rams #6 + Segall "Think Brutal" | CRITICAL | `honest-` | 6 |
| 4 | Invisible Design | Rams #5 + Edson "Product Is Marketing" | HIGH | `invisible-` | 6 |
| 5 | Systems, Not Pieces | Edson "Systems Thinking" + Rams #8 | HIGH | `system-` | 6 |
| 6 | Thorough to the Last Detail | Rams #8 + Rams #2 | HIGH | `thorough-` | 7 |
| 7 | Enduring Over Trendy | Rams #7 + Edson "Design With Conviction" | MEDIUM-HIGH | `enduring-` | 5 |
| 8 | Refined Through Iteration | Edson "Design Out Loud" + Rams #1/#3 | MEDIUM | `refined-` | 8 |

## Quick Reference

### 1. Less, But Better (CRITICAL)

Rams #10: "Good design is as little design as possible." Segall: Apple succeeded by saying no to a thousand things.

- [`less-single-focal`](references/less-single-focal.md) - One primary focal point per screen
- [`less-type-restraint`](references/less-type-restraint.md) - Limit to 3-4 distinct type treatments per screen
- [`less-one-typeface`](references/less-one-typeface.md) - One typeface per app, differentiate with weight and size
- [`less-color-restraint`](references/less-color-restraint.md) - Reserve saturated colors for small interactive elements
- [`less-one-color-purpose`](references/less-one-color-purpose.md) - Each semantic color serves exactly one purpose
- [`less-purposeful-motion`](references/less-purposeful-motion.md) - Every animation must communicate state change or provide feedback
- [`less-fewer-controls`](references/less-fewer-controls.md) - Remove controls that do not serve the core task

### 2. Self-Evident Design (CRITICAL)

Rams #4: "Good design makes a product understandable." Segall: interfaces must speak in terms people understand.

- [`evident-visual-weight`](references/evident-visual-weight.md) - Combine size, weight, and contrast for hierarchy
- [`evident-whitespace-grouping`](references/evident-whitespace-grouping.md) - Use whitespace to separate conceptual groups
- [`evident-progressive-disclosure`](references/evident-progressive-disclosure.md) - Use progressive disclosure for dense information
- [`evident-reading-order`](references/evident-reading-order.md) - Align visual weight with logical reading order
- [`evident-navigation-intent`](references/evident-navigation-intent.md) - Sheets for tasks and creation, push for drill-down hierarchy
- [`evident-label-clarity`](references/evident-label-clarity.md) - Use clear labels over ambiguous icons

### 3. Honest Interfaces (CRITICAL)

Rams #6: "Good design is honest." Segall: clarity without sugar-coating.

- [`honest-semantic-colors`](references/honest-semantic-colors.md) - Use semantic colors, never hard-coded black or white
- [`honest-contrast`](references/honest-contrast.md) - Ensure WCAG AA contrast ratios
- [`honest-dark-mode`](references/honest-dark-mode.md) - Define light and dark variants for every custom color
- [`honest-foreground-style`](references/honest-foreground-style.md) - Use foregroundStyle over foregroundColor
- [`honest-depth-cues`](references/honest-depth-cues.md) - Use materials for layering, not drop shadows for depth
- [`honest-loading-states`](references/honest-loading-states.md) - Show real progress, not indefinite spinners

### 4. Invisible Design (HIGH)

Rams #5: "Good design is unobtrusive." Edson: the product itself is the marketing.

- [`invisible-spring-physics`](references/invisible-spring-physics.md) - Default to spring animations for all UI transitions
- [`invisible-spring-presets`](references/invisible-spring-presets.md) - Use .smooth for routine, .snappy for interactive, .bouncy for delight
- [`invisible-no-easing`](references/invisible-no-easing.md) - Prefer springs over linear and easeInOut for UI elements
- [`invisible-system-materials`](references/invisible-system-materials.md) - Use system materials, not custom semi-transparent backgrounds
- [`invisible-symbol-effects`](references/invisible-symbol-effects.md) - Use built-in symbolEffect, not manual symbol animation
- [`invisible-content-transitions`](references/invisible-content-transitions.md) - Use contentTransition for changing text and numbers

### 5. Systems, Not Pieces (HIGH)

Edson: "Design is systems thinking." Rams #8: nothing must be arbitrary or left to chance.

- [`system-spacing-grid`](references/system-spacing-grid.md) - Use a 4pt base unit for all spacing
- [`system-consistent-padding`](references/system-consistent-padding.md) - Use consistent padding across all screens
- [`system-corner-radii`](references/system-corner-radii.md) - Standardize corner radii per component type
- [`system-alignment`](references/system-alignment.md) - Consistent alignment per content type within a screen
- [`system-color-naming`](references/system-color-naming.md) - Name custom colors by role, not hue
- [`system-brand-integration`](references/system-brand-integration.md) - Map brand palette onto iOS semantic color roles

### 6. Thorough to the Last Detail (HIGH)

Rams #8: "Care and accuracy in the design process show respect for the user." Rams #2: if the user cannot reliably use it, the product has failed.

- [`thorough-reduce-motion`](references/thorough-reduce-motion.md) - Always provide reduce motion fallback
- [`thorough-touch-targets`](references/thorough-touch-targets.md) - All interactive elements at least 44x44 points
- [`thorough-safe-areas`](references/thorough-safe-areas.md) - Always respect safe areas
- [`thorough-readable-weights`](references/thorough-readable-weights.md) - Avoid light font weights for body text
- [`thorough-vibrancy-levels`](references/thorough-vibrancy-levels.md) - Match vibrancy level to content importance
- [`thorough-material-thickness`](references/thorough-material-thickness.md) - Choose material thickness by contrast needs
- [`thorough-background-interaction`](references/thorough-background-interaction.md) - Enable background interaction for peek-style sheets

### 7. Enduring Over Trendy (MEDIUM-HIGH)

Rams #7: "Good design is long-lasting." Edson: commit to a voice that persists across product generations.

- [`enduring-system-text-styles`](references/enduring-system-text-styles.md) - Use Apple text styles, never fixed font sizes
- [`enduring-weight-not-caps`](references/enduring-weight-not-caps.md) - Use weight for emphasis, not ALL CAPS
- [`enduring-swipe-back`](references/enduring-swipe-back.md) - Never break the system back-swipe gesture
- [`enduring-zoom-navigation`](references/enduring-zoom-navigation.md) - Use zoom transitions for collection-to-detail navigation
- [`enduring-card-modularity`](references/enduring-card-modularity.md) - Use self-contained cards for dashboard layouts

### 8. Refined Through Iteration (MEDIUM)

Edson: "Design out loud" — prototype relentlessly until every interaction feels inevitable. Rams #1: innovation serves genuine purpose.

- [`refined-scroll-transitions`](references/refined-scroll-transitions.md) - Use scrollTransition for scroll-position visual effects
- [`refined-phase-animator`](references/refined-phase-animator.md) - Use PhaseAnimator for multi-step animation sequences
- [`refined-mesh-gradients`](references/refined-mesh-gradients.md) - Use MeshGradient for premium dynamic backgrounds
- [`refined-text-renderer`](references/refined-text-renderer.md) - Use TextRenderer for hero text animations only
- [`refined-inspector`](references/refined-inspector.md) - Use inspector for trailing-edge detail panels
- [`refined-multi-detent`](references/refined-multi-detent.md) - Provide multiple sheet detents with drag indicator
- [`refined-matched-geometry`](references/refined-matched-geometry.md) - Use matchedGeometryEffect for contextual origin transitions
- [`refined-no-hard-cuts`](references/refined-no-hard-cuts.md) - Always animate between states, even minimally

## How to Use

Read individual reference files for detailed explanations and code examples:

- [Section definitions](references/_sections.md) - Category structure, principle sources, and impact levels
- [Rule template](assets/templates/_template.md) - Template for adding new rules

## Reference Files

| File | Description |
|------|-------------|
| [references/_sections.md](references/_sections.md) | Category definitions and principle grounding |
| [assets/templates/_template.md](assets/templates/_template.md) | Template for new rules |
| [metadata.json](metadata.json) | Version and reference information |

© pproenca · MIT · pproenca/dot-skills

Похожие скиллы

Все скиллы по теме «Дизайн» →
swiftui-view-refactor официальный OpenAI Скилл swiftui-view-refactor наводит порядок в коде SwiftUI: делит разросшиеся экраны на отдельные структуры View и выносит побочные эффекты из body. CX Codex GP ChatGPT +1 113установок ios-development rshankras Скилл ios-development для iOS-разработки: разбор Swift-кода, проверка UI по Apple HIG, аудит доступности и планирование приложения. CX Codex +1 871установок ios-application-dev MiniMax-OpenSource Скилл ios-application-dev для Claude Code — справочник по UIKit, SnapKit и SwiftUI с чек-листами для проверки iOS-интерфейсов. CX Codex +1 2 200установок ios-dev Prisma-Labs-Dev Скилл ios-dev для Claude Code координирует руководства по паттернам, проверку корректности и справочники Apple при разработке под iOS и SwiftUI. CX Codex +1 813установок build-ios-apps официальный OpenAI Плагин build-ios-apps для Codex и ChatGPT объединяет скиллы для разработки под iOS: от SwiftUI и App Intents до профилирования ETTrace и поиска утечек по memgraph. CX Codex GP ChatGPT ★ 8 052звёзд репо ios-swift-development aj-geddes Скилл ios-swift-development для разработки нативных iOS-приложений на Swift в Claude Code. Охватывает MVVM, SwiftUI, асинхронные запросы через URLSession и сохранение данных с Core Data. CX Codex +1 1 500установок

Из того же набора139

Весь набор →
ruby-refactor Скилл ruby-refactor со сводом из 45 правил рефакторинга Ruby-кода. Помогает агенту упрощать условия, снижать зацепление классов и внедрять синтаксис Ruby 3.x. CX Codex +1 307установок ios-xcode Скилл ios-xcode для Claude Code помогает настраивать Xcode-проекты и повседневные инструменты для iOS. Он подключается при работе с App-target, SwiftData, тестами, отладкой и распространением приложения. CX Codex +1 307установок think Скилл think для Claude Code переводит ИИ в режим глубокого анализа и ищет эффективные решения, связывая идеи из разных областей. Помогает выработать стратегию, а не инструкцию. CX Codex +1 307установок restful-hateoas Скилл restful-hateoas внедряет в ИИ-агента 47 правил проектирования REST API третьего уровня зрелости Ричардсона для приложений на Ruby on Rails. CX Codex +1 304установок rails-dev Скилл rails-dev для Claude Code задаёт правила разработки на Ruby on Rails: контроллеры, ActiveRecord и кеширование. Включается при рефакторинге моделей, миграциях и работе с Turbo Frames. CX Codex +1 299установок swift-optimise Скилл swift-optimise разбирает производительность Swift и SwiftUI: конкуренцию, отрисовку и анимации. Нужен при профилировании clinic-модулей. CX Codex +1 293установок ruby-optimise Скилл ruby-optimise для Claude Code подсказывает, как писать и проверять Ruby-код с учётом производительности. Разбирает работу с коллекциями, ActiveRecord и выделением памяти. CX Codex +1 292установок swift-refactor Скилл swift-refactor для Claude Code помогает перестроить существующий код SwiftUI под модульную MVVM-C-архитектуру. Он подключается к задачам по навигации, состоянию и разделению приложения на слои. CX Codex +1 289установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой