Codex용 SwiftUI UI Patterns 스킬.
swiftui-ui-patterns 스킬은 SwiftUI 화면을 만들고 리팩터링할 때 쓸 기본 패턴을 Codex에 줍니다. 상태를 어디에 둘지, 내비게이션과 시트를 어떻게 연결할지, 뷰를 어떻게 작게 나눌지입니다. 컴포넌트나 주제마다 하나씩, 30개 정도의 짧은 참고 문서가 함께 들어 있습니다. OpenAI의 Build iOS Apps 플러그인에 들어 있습니다.
2026년 11월 12일 업데이트 · 3분 분량
한눈에 보기
| 스킬 이름 | swiftui-ui-patterns |
| 제공 | Build iOS Apps 플러그인(OpenAI 제작) |
| 설치 | codex plugin add build-ios-apps@openai-curated 또는 Codex에서 /plugins |
| Codex가 쓰는 때 | SwiftUI UI를 만들거나 리팩터링할 때: 내비게이션, 상태, 레이아웃, 컨트롤, 화면 구성 |
| 출처 | GitHub의 openai/plugins |
하는 일
기존 프로젝트에서는 Codex가 먼저 저장소에서 가까운 SwiftUI 뷰를 찾아 그 컨벤션을 따릅니다. 새 프로젝트에서는 TabView, NavigationStack, 시트를 설정하는 앱 연결 참고 문서에서 시작하며, 화면이 늘어날 때마다 확장하는 라우트 enum과 시트 enum을 함께 둡니다.
일반 규칙은 다음과 같습니다.
- 상태:
@State와@Binding부터@Observable모델, 공유 서비스용@Environment까지, 맞는 것 중 가장 범위가 좁은 도구를 씁니다. 단순한 상태로 충분하면 뷰 모델을 두지 않고, iOS 16 이하에는ObservableObject로 대체합니다. - 구성: 거대한 뷰 하나 대신 작고 역할이 분명한 하위 뷰로 나눕니다.
- 비동기 작업: 로딩과 오류 상태를 명시한
.task를 씁니다. - 시트:
.sheet(isPresented:)보다.sheet(item:)을 쓰고, 시트는 스스로 닫힙니다. - OS 버전: 배포 대상에 맞는 가장 최신 API를 쓰고, 최소 OS 버전을 명시합니다.
피해야 할 안티패턴도 나열합니다. 서로 배타적인 시트를 위해 boolean을 여러 개 두는 것, body 안의 네트워크 호출, 우회책으로 쓰는 AnyView 등입니다. 새 뷰를 만들 때 Codex는 단계마다 빌드하고 주요 상태별 프리뷰를 추가합니다. 참고 문서는 리스트, 폼, 그리드, 검색, 분할 뷰, 메뉴 막대, macOS 설정, 햅틱, 테마, 성능 등을 다룹니다.
언제 쓰나요
새 화면, 탭 구조, 큰 뷰 정리 등 일상적인 SwiftUI 작업에 쓰세요. Codex의 코드를 최신 SwiftUI와 앱에서 이미 쓰는 패턴에 맞춰 줍니다.
써 보기
swiftui-ui-patterns 스킬을 사용해 주세요. 읽기 목록 앱의 앱 셸을 설정해 주세요. 탭은 세 개(Library, Search, Settings)이고 각각 자체 NavigationStack을 가지며, 책 추가는 enum으로 제어하는 시트로 만들어 주세요. 빈 상태와 데이터가 로드된 상태의 프리뷰도 추가해 주세요.
Claude Code에서도 되나요?
네. 이 스킬은 일반 지침과 Markdown 참고 문서로만 되어 있고 Codex 전용 도구가 없으므로, GitHub에서 폴더를 ~/.claude/skills로 복사하면 됩니다.