Communitygithub.com

ulasalyesil/personal-website-v2

SwiftUI 뷰 및 컴포넌트 구축을 위한 모범 사례 및 예제 중심 가이드입니다. SwiftUI UI를 만들거나 리팩토링할 때, TabView로 탭 아키텍처를 설계할 때, 화면을 구성할 때, 또는 컴포넌트별 패턴과 예제가 필요할 때 사용하세요.

personal-website-v2란 무엇인가요?

이 스킬은 개발자가 SwiftUI로 사용자 인터페이스를 구축할 때 일관된 패턴과 모범 사례를 따르도록 돕는 종합 가이드입니다. 기존 프로젝트에 기능을 추가하거나 새 프로젝트를 스캐폴딩할 때 빠르게 시작할 수 있는 두 가지 트랙을 제공합니다. SwiftUI 네이티브 상태 관리( @State, @Binding, @Observable, @Environment ), 비동기(async/await) 처리, 접근성 등을 강조하며, 시트(sheet) 패턴에서는 .sheet(item:) 사용과 시트 내에서의 dismiss() 호출을 권장합니다. 또한 components-index.md를 통해 재사용 가능한 컴포넌트 참조를 제공하고, 새로운 컴포넌트 참조를 추가하는 방법도 안내합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agent/skills/swiftui-ui-patterns

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

SwiftUI UI 패턴

빠른 시작

목표에 따라 트랙을 선택하세요:

기존 프로젝트

  • 기능 또는 화면과 기본 상호작용 모델(목록, 상세, 편집기, 설정, 탭)을 식별합니다.
  • rg "TabView\(" 등으로 저장소에서 비슷한 예제를 찾은 다음, 가장 가까운 SwiftUI 뷰를 읽습니다.
  • 로컬 규칙을 적용합니다: SwiftUI 네이티브 상태를 선호하고, 가능하면 상태를 로컬로 유지하며, 공유 종속성에는 환경(Environment) 주입을 사용합니다.
  • references/components-index.md에서 관련 컴포넌트 참조를 선택하고 그 지침을 따릅니다.
  • 작고 집중된 하위 뷰와 SwiftUI 네이티브 데이터 흐름으로 뷰를 구축합니다.

새 프로젝트 스캐폴딩

  • references/app-scaffolding-wiring.md로 시작하여 TabView + NavigationStack + 시트를 연결합니다.
  • 제공된 스켈레톤을 기반으로 최소 AppTab과 RouterPath를 추가합니다.
  • 먼저 필요한 UI(TabView, NavigationStack, 시트)에 따라 다음 컴포넌트 참조를 선택합니다.
  • 새 화면이 추가됨에 따라 라우트 및 시트 열거형을 확장합니다.

따라야 할 일반 규칙

  • 최신 SwiftUI 상태(@State, @Binding, @Observable, @Environment)를 사용하고 불필요한 뷰 모델을 피합니다.
  • 구성을 선호하며, 뷰를 작고 집중적으로 유지합니다.
  • .task와 명시적 로딩/오류 상태와 함께 async/await를 사용합니다.
  • 기존 레거시 파일을 편집할 때만 기존 레거시 패턴을 유지합니다.
  • 프로젝트의 포매터 및 스타일 가이드를 따릅니다.
  • 시트(Sheets): 상태가 선택된 모델을 나타낼 때는 .sheet(isPresented:)보다 .sheet(item:)을 선호합니다. 시트 본문에서 if let을 사용하지 마세요. 시트는 자체 작업을 소유하고 onCancel/onConfirm 클로저를 전달하는 대신 내부적으로 dismiss()를 호출해야 합니다.

새 SwiftUI 뷰 작업 흐름

  1. 뷰의 상태와 그 소유권 위치를 정의합니다.
  2. @Environment를 통해 주입할 종속성을 식별합니다.
  3. 뷰 계층 구조를 스케치하고 반복되는 부분을 하위 뷰로 추출합니다.
  4. .task와 필요한 경우 명시적 상태 열거형을 사용하여 비동기 로딩을 구현합니다.
  5. UI가 상호작용할 때 접근성 레이블 또는 식별자를 추가합니다.
  6. 빌드로 검증하고 필요한 경우 사용처를 업데이트합니다.

컴포넌트 참조

references/components-index.md를 진입점으로 사용하세요. 각 컴포넌트 참조에는 다음이 포함되어야 합니다:

  • 의도 및 최적의 사용 시나리오.
  • 로컬 규칙을 포함한 최소 사용 패턴.
  • 함정 및 성능 참고 사항.
  • 현재 저장소의 기존 예제 경로.

시트 패턴

아이템 기반 시트 (선호)

@State private var selectedItem: Item?

.sheet(item: $selectedItem) { item in
    EditItemSheet(item: item)
}

시트가 자체 작업을 소유

struct EditItemSheet: View {
    @Environment(\.dismiss) private var dismiss
    @Environment(Store.self) private var store

    let item: Item
    @State private var isSaving = false

    var body: some View {
        VStack {
            Button(isSaving ? "저장 중…" : "저장") {
                Task { await save() }
            }
        }
    }

    private func save() async {
        isSaving = true
        await store.save(item)
        dismiss()
    }
}

새 컴포넌트 참조 추가

  • references/<component>.md를 생성합니다.
  • 짧고 실행 가능하게 유지하며, 현재 저장소의 구체적인 파일에 링크합니다.
  • 새 항목으로 references/components-index.md를 업데이트합니다.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ulasalyesil/personal-website-v2

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

ulasalyesil/personal-website-v2

Conduct design interviews, generate five distinct UI variations in a temporary design lab, collect feedback, and produce implementation plans. Use when the user wants to explore UI design options, redesign existing components, or create new UI with multiple approaches to compare.

ulasalyesil/personal-website-v2

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

ulasalyesil/personal-website-v2

Design and implement microinteractions, motion design, transitions, and user feedback patterns. Use when adding polish to UI interactions, implementing loading states, or creating delightful user experiences.

ulasalyesil/personal-website-v2

This skill is for interface design — dashboards, admin panels, apps, tools, and interactive products. NOT for marketing design (landing pages, marketing sites, campaigns).

ulasalyesil/personal-website-v2

UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples.

ulasalyesil/personal-website-v2

Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance. Use when auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns.

ulasalyesil/personal-website-v2

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

ulasalyesil/personal-website-v2

Enforces an opinionated UI baseline to prevent AI-generated interface slop.

ulasalyesil/personal-website-v2

Build modern, composable, and accessible React UI components following the components.build specification. Use when creating, reviewing, or refactoring component libraries, design systems, or any reusable UI components. Triggers on tasks involving component APIs, composition patterns, accessibility, styling systems, or TypeScript props.

ulasalyesil/personal-website-v2

Ship correct, complete metadata.

ulasalyesil/personal-website-v2

Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on source code — never implements, fixes, or refactors anything itself. Use when asked to audit a codebase, find improvement opportunities (bugs, security, performance, test coverage, tech debt, migrations, DX), suggest features or where to take the project next (roadmap, product direction), or generate handoff plans for another agent to implement.

ulasalyesil/personal-website-v2

Defines the product's objects, relationships, states, and vocabulary independently of any interface — the most load-bearing layer

ulasalyesil/personal-website-v2

Maps domain concepts, terminology conflicts, and bounded contexts — produces a noun harvest for the conceptual model layer

ulasalyesil/personal-website-v2

Maps interaction structure and flow — produces breadboard notation with edge cases, failure paths, and open decisions

ulasalyesil/personal-website-v2

Framework orientation for Layers of Product Design — load this first; provides the context all other skills depend on

ulasalyesil/personal-website-v2

User research planning and synthesis at the observed behaviour layer — produces candidate job stories with confidence ratings

ulasalyesil/personal-website-v2

Diagnostic audit across all seven layers — identifies the bottleneck layer and recommends where to focus

ulasalyesil/personal-website-v2

Connects user opportunities to business outcomes and solution bets — produces a strategy tree and prioritised experiments

ulasalyesil/personal-website-v2

Audits existing surface against lower-layer decisions and produces a surface decision inventory — vocabulary, object consistency, completeness, feedback, hierarchy, accessibility

관련 스킬