Communitygithub.com

ulasalyesil/personal-website-v2

디자인 인터뷰를 진행하고, 임시 디자인 랩에서 5가지 고유한 UI 변형을 생성하며, 피드백을 수집하고, 구현 계획을 수립합니다. 사용자가 UI 디자인 옵션을 탐색하거나, 기존 컴포넌트를 재설계하거나, 비교할 여러 접근 방식으로 새 UI를 만들고자 할 때 사용하세요.

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

이 스킬은 디자인 인터뷰, 변형 생성, 피드백 수집, 개선, 미리보기 및 최종 결정을 포함한 전체 디자인 탐색 워크플로우를 구현합니다. 사용자의 프로젝트에서 패키지 매니저, 프레임워크, 스타일링 시스템 및 기존 디자인 패턴을 자동으로 감지하여 일관된 시각적 언어를 유지합니다. 인터뷰 단계에서는 범위, 페인 포인트, 브랜드 톤, 사용자 페르소나 및 제약 조건을 질문하여 구조화된 디자인 브리프를 작성하며, 이후 5가지 뚜렷하게 다른 UI 변형을 생성합니다. 가장 중요한 기능은 인터랙티브 피드백 시스템으로, 사용자가 각 변형에 대해 인라인으로 의견을 제시할 수 있게 해줍니다. 최종 디자인이 확정되면 스킬은 컴포넌트 또는 페이지에 대한 상세 구현 계획을 생성하고 모든 임시 파일을 정리합니다. 이 스킬은 Next.js, Vite, Remix, Nuxt, Astro 등 주요 프레임워크와 Tailwind CSS, Material UI, Chakra UI 등 스타일링 시스템을 지원합니다. 취소 또는 중단 시 모든 임시 아티팩트가 즉시 삭제되므로 프로젝트가 깨끗한 상태로 유지됩니다.

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

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

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

문서

디자인 랩 스킬

이 스킬은 전체 디자인 탐색 워크플로우(인터뷰, 변형 생성, 피드백 수집, 개선, 미리보기 및 최종 결정)를 구현합니다.

중요: 정리 동작

프로세스가 종료되면 모든 임시 파일이 반드시 삭제되어야 합니다. 다음 상황에 해당합니다:

  • 사용자가 최종 디자인을 확정 → 정리 후 계획 생성
  • 사용자가 중단/취소 → 즉시 정리, 계획 생성하지 않음

절대 .claude-design/ 또는 __design_lab 경로를 남겨두지 마십시오. 사용자가 언제든 "취소", "중단", "그만", "괜찮아"라고 말하면 확인 후 모든 임시 아티팩트를 삭제하십시오.


단계 0: 사전 탐지

인터뷰를 시작하기 전에 자동으로 다음을 탐지합니다:

패키지 매니저

프로젝트 루트에서 잠금 파일 확인:

  • pnpm-lock.yaml → pnpm 사용
  • yarn.lock → yarn 사용
  • package-lock.json → npm 사용
  • bun.lockb → bun 사용

프레임워크 탐지

설정 파일 확인:

  • next.config.js 또는 next.config.mjs 또는 next.config.ts → Next.js
    • app/ 디렉토리 확인 → App Router
    • pages/ 디렉토리 확인 → Pages Router
  • vite.config.js 또는 vite.config.ts → Vite
  • remix.config.js → Remix
  • nuxt.config.js 또는 nuxt.config.ts → Nuxt
  • astro.config.mjs → Astro

스타일링 시스템 탐지

package.json 종속성 및 설정 파일 확인:

  • tailwind.config.js 또는 tailwind.config.ts → Tailwind CSS
  • @mui/material이 종속성에 있음 → Material UI
  • @chakra-ui/react가 종속성에 있음 → Chakra UI
  • antd가 종속성에 있음 → Ant Design
  • styled-components가 종속성에 있음 → styled-components
  • @emotion/react가 종속성에 있음 → Emotion
  • .css 또는 .module.css 파일 → CSS Modules

디자인 메모리 확인

기존 디자인 메모리 파일 확인:

  • docs/design-memory.md
  • DESIGN_MEMORY.md
  • .claude-design/design-memory.md

발견하면 읽어서 기본값을 미리 채우고 중복 질문을 건너뜁니다.

시각적 스타일 추론 (중요)

일반/사전 정의된 스타일을 사용하지 마십시오. 프로젝트에서 시각적 언어를 추출하십시오:

Tailwind가 탐지되면, tailwind.config.js 또는 tailwind.config.ts를 읽습니다:

// 추출하여 사용:
theme.colors      // 색상 팔레트
theme.spacing     // 간격 스케일
theme.borderRadius // 테두리 반경 값
theme.fontFamily  // 타이포그래피
theme.boxShadow   // 그림자 시스템

CSS 변수가 있으면, globals.css, variables.css 또는 :root 정의를 읽습니다:

:root {
  --color-*     /* 색상 토큰 */
  --spacing-*   /* 간격 토큰 */
  --font-*      /* 타이포그래피 토큰 */
  --radius-*    /* 테두리 반경 토큰 */
}

UI 라이브러리가 탐지되면 (MUI, Chakra, Ant), 테마 설정을 읽습니다:

  • MUI: theme.ts 또는 createTheme() 호출
  • Chakra: theme/index.ts 또는 extendTheme() 호출
  • Ant: ConfigProvider 테마 prop

항상 기존 컴포넌트를 스캔하여 패턴을 이해합니다:

  • 2-3개의 기존 버튼 찾기 → 스타일링 패턴 기록
  • 2-3개의 기존 카드 찾기 → 패딩, 테두리, 그림자 기록
  • 기존 폼 찾기 → 입력 스타일, 레이블 배치 기록
  • 기존 타이포그래피 찾기 → 제목 크기, 본문 텍스트 기록

추론된 스타일을 디자인 브리프에 저장하여 모든 변형에서 일관되게 사용합니다.


단계 1: 인터뷰

모든 인터뷰 단계에 AskUserQuestion 도구를 사용하십시오. 디자인 메모리가 있으면 그에 따라 질문을 조정합니다.

단계 1.1: 범위 및 대상

다음 질문을 합니다 (단일 AskUserQuestion에 여러 질문을 결합 가능):

질문 1: 범위

  • 헤더: "범위"
  • 질문: "단일 컴포넌트를 디자인할까요, 아니면 전체 페이지를 디자인할까요?"
  • 옵션:
    • "컴포넌트" - 재사용 가능한 UI 요소 (버튼, 카드, 폼, 모달 등)
    • "페이지" - 완전한 페이지 또는 화면 레이아웃

질문 2: 신규 또는 재설계

  • 헤더: "유형"
  • 질문: "새로운 디자인인가요, 아니면 기존 것을 재설계하는 것인가요?"
  • 옵션:
    • "신규" - 처음부터 새로 만듦
    • "재설계" - 기존 컴포넌트/페이지 개선

"재설계"를 선택한 경우, 물어볼 질문: 질문 3: 기존 경로

  • 헤더: "위치"
  • 질문: "기존 UI의 파일 경로 또는 경로는 무엇인가요?"
  • 옵션: (사용자가 "기타"를 통해 제공)

대상이 명확하지 않으면, 저장소 패턴을 기반으로 이름을 제안하고 확인합니다.

단계 1.2: 문제점 및 영감

질문 1: 문제점

  • 헤더: "문제점"
  • 질문: "현재 디자인의 가장 큰 문제점은 무엇인가요? (또는 이 새 디자인이 피해야 할 것은?)"
  • 옵션:
    • "너무 복잡함/빽빽함" - 정보 과부하, 스캔하기 어려움
    • "계층 구조가 불명확함" - 주요 작업이 눈에 띄지 않음
    • "모바일 경험 부족" - 작은 화면에서 제대로 작동하지 않음
    • "구식 디자인" - 브랜드와 일관성이 없거나 낡아 보임
  • multiSelect: true

질문 2: 시각적 영감

  • 헤더: "시각적 스타일"
  • 질문: "시각적 영감을 위해 참고할 제품이나 브랜드는 무엇인가요?"
  • 옵션:
    • "Stripe" - 깔끔함, 미니멀함, 신뢰감
    • "Linear" - 빽빽함, 키보드 우선, 개발자 중심
    • "Notion" - 유연함, 콘텐츠 중심, 유쾌함
    • "Apple" - 프리미엄, 여백이 많음, 정교함
  • multiSelect: true

질문 3: 기능적 영감

  • 헤더: "상호작용"
  • 질문: "어떤 상호작용 패턴을 모방해야 할까요?"
  • 옵션:
    • "인라인 편집" - 모달 없이 제자리에서 편집
    • "점진적 공개" - 필요에 따라 더 많은 정보 표시
    • "낙관적 업데이트" - 즉각적인 피드백, 백그라운드에서 동기화
    • "키보드 단축키" - 고급 사용자 효율성 향상

단계 1.3: 브랜드 및 스타일 방향

질문 1: 브랜드 형용사

  • 헤더: "브랜드 톤"
  • 질문: "원하는 브랜드 느낌을 설명하는 형용사 3-5개는 무엇인가요?"
  • 옵션:
    • "미니멀" - 깔끔함, 단순함, 정리됨
    • "프리미엄" - 고급스러움, 세련됨, 정교함
    • "유쾌함" - 재미있음, 친근함, 접근하기 쉬움
    • "실용적" - 기능적, 효율적, 불필요한 것 없음
  • multiSelect: true

질문 2: 밀도

  • 헤더: "밀도"
  • 질문: "선호하는 정보 밀도는 무엇인가요?"
  • 옵션:
    • "조밀한" - 더 많은 정보 표시, 간격 좁힘
    • "편안한" - 균형 잡힌 간격, 쉬운 스캔
    • "여유로운" - 넉넉한 여백, 집중된 주의

질문 3: 다크 모드

  • 헤더: "다크 모드"
  • 질문: "다크 모드가 필요한가요?"
  • 옵션:
    • "예" - 반드시 다크 모드 지원
    • "아니오" - 라이트 모드만
    • "있으면 좋음" - 쉽다면 지원, 필수는 아님

단계 1.4: 페르소나 및 잡스-투-비-던

질문 1: 주요 사용자

  • 헤더: "사용자"
  • 질문: "주요 최종 사용자는 누구인가요?"
  • 옵션:
    • "개발자" - 기술적, 키보드 지향
    • "디자이너" - 시각적, 세부 지향
    • "비즈니스 사용자" - 효율성 중심, 덜 기술적
    • "최종 소비자" - 일반 대중, 다양한 기술 수준

질문 2: 맥락

  • 헤더: "맥락"
  • 질문: "주요 사용 맥락은 무엇인가요?"
  • 옵션:
    • "데스크톱 우선" - 주로 큰 화면에서 사용
    • "모바일 우선" - 주로 휴대폰에서 사용
    • "둘 다 동등" - 모든 기기에서 잘 작동해야 함

질문 3: 주요 작업

  • 헤더: "주요 작업"
  • 질문: "사용자가 반드시 완료해야 하는 상위 3가지 작업은 무엇인가요?"
  • (사용자가 "기타"를 통해 제공 - 열린 질문)

단계 1.5: 제약 조건

질문 1: 유지해야 할 요소

  • 헤더: "유지"
  • 질문: "반드시 유지해야 할 요소가 있나요?"
  • 옵션:
    • "기존 복사본/라벨" - 현재 텍스트 유지
    • "현재 필드/입력" - 폼 구조 유지
    • "내비게이션 구조" - 현재 내비게이션 유지
    • "없음" - 모든 것을 자유롭게 변경 가능

질문 2: 기술적 제약

  • 헤더: "제약 조건"
  • 질문: "기술적 제약 사항이 있나요?"
  • 옵션:
    • "새로운 종속성 없음" - 기존 라이브러리만 사용
    • "기존 컴포넌트 사용" - 현재 디자인 시스템 기반으로 구축
    • "접근성 준수 (WCAG)" - 엄격한 접근성 요구 사항
    • "없음" - 특별한 제약 없음
  • multiSelect: true

단계 2: 디자인 브리프 생성

인터뷰 후, 구조화된 디자인 브리프를 JSON으로 생성하여 .claude-design/design-brief.json에 저장합니다:

{
  "scope": "component|page",
  "isRedesign": true|false,
  "targetPath": "src/components/Example.tsx",
  "targetName": "Example",
  "painPoints": ["너무 빽빽함", "주요 작업이 불명확함"],
  "inspiration": {
    "visual": ["Stripe", "Linear"],
    "functional": ["인라인 검증"]
  },
  "brand": {
    "adjectives": ["미니멀", "신뢰감"],
    "density": "편안한",
    "darkMode": true
  },
  "persona": {
    "primary": "개발자",
    "context": "desktop-first",
    "keyTasks": ["결제 완료", "주문 검토", "할인 적용"]
  },
  "constraints": {
    "mustKeep": ["기존 필드"],
    "technical": ["새로운 종속성 없음", "WCAG 접근성 준수"]
  },
  "framework": "nextjs-app",
  "packageManager": "pnpm",
  "stylingSystem": "tailwind"
}

진행하기 전에 사용자에게 요약을 표시합니다.


단계 3: 디자인 랩 생성

디렉토리 구조

모든 파일을 .claude-design/ 아래에 생성합니다:

.claude-design/
├── lab/
│   ├── page.tsx                 # 메인 랩 페이지 (프레임워크별)
│   ├── variants/
│   │   ├── VariantA.tsx
│   │   ├── VariantB.tsx
│   │   ├── VariantC.tsx
│   │   ├── VariantD.tsx
│   │   └── VariantE.tsx
│   ├── components/
│   │   └── LabShell.tsx         # 랩 레이아웃 래퍼
│   ├── feedback/                # 인터랙티브 피드백 시스템
│   │   ├── types.ts             # TypeScript 인터페이스
│   │   ├── selector-utils.ts    # 요소 식별
│   │   ├── format-utils.ts      # 피드백 형식 지정
│   │   ├── FeedbackOverlay.tsx  # 메인 오버레이 컴포넌트
│   │   └── index.ts             # 모듈 내보내기
│   └── data/
│       └── fixtures.ts          # 공유 모의 데이터
├── design-brief.json
└── run-log.md

피드백 시스템 설정 (중요 - 절대 건너뛰지 마십시오)

FeedbackOverlay는 디자인 랩의 핵심 기능입니다. 이것이 없으면 사용자가 인터랙티브 피드백을 제공할 수 없습니다. FeedbackOverlay 없이 디자인 랩을 절대 생성하지 마십시오.

안정성 전략: 다양한 프로젝트 설정에서 임포트 경로 문제를 피하기 위해, FeedbackOverlay를 경로 디렉토리(예: app/design-lab/FeedbackOverlay.tsx)에 직접 생성하고 .claude-design/에는 생성하지 마십시오. 이렇게 하면 간단한 상대 경로 임포트(./FeedbackOverlay)가 항상 작동합니다.

경로 디렉토리의 필수 파일:

app/design-lab/           # 또는 app/__design_lab/ (밑줄이 작동하는 경우)
├── page.tsx              # 변형이 포함된 메인 랩 페이지
└── FeedbackOverlay.tsx   # 독립형 오버레이 컴포넌트 (템플릿에서 복사)

템플릿 출처: design-and-refine/templates/feedback/FeedbackOverlay.tsx

이 접근 방식의 이유:

  • .claude-design/ 경로는 번들러 설정 때문에 실패할 수 있음
  • 같은 디렉토리의 상대 경로 임포트는 항상 작동함
  • 경로 디렉토리는 정리 중에 어차피 삭제됨

경로 통합

Next.js App Router: app/__design_lab/page.tsx를 생성하여 .claude-design/lab/에서 임포트합니다.

Next.js Pages Router: pages/__design_lab.tsx를 생성하여 .claude-design/lab/에서 임포트합니다.

Vite React:

  • React Router가 있는 경우: /__design_lab 경로 추가
  • 라우터가 없는 경우: App.tsx에 ?design_lab=true 쿼리 파라미터 기반 조건부 렌더링 생성

기타 프레임워크: 탐지된 프레임워크에 가장 적합한 임시 경로를 생성합니다.

변형 생성 지침

중요: UX, 상호작용 및 모션 모범 사례를 위해 DESIGN_PRINCIPLES.md를 읽으십시오. 그러나 사전 정의된 시각적 스타일을 사용하지 말고 프로젝트에서 추론하십시오.

보편적 원칙 적용 (DESIGN_PRINCIPLES.md에서):

  • UX: Nielsen의 휴리스틱, 인지 부하 감소, 점진적 공개
  • 컴포넌트 동작: 버튼 상태, 폼 구조, 카드 구조
  • 상호작용: 피드백 패턴, 상태 처리, 낙관적 업데이트
  • 모션: 타이밍 (150-300ms), 이징 (ease-out 진입, ease-in 종료)
  • 접근성: 포커스 상태, ARIA 패턴, 터치 대상 (최소 44px)

프로젝트에서 시각적 스타일 추론:

  • 색상 → Tailwind 설정, CSS 변수 또는 기존 컴포넌트에서
  • 타이포그래피 → 코드베이스의 기존 제목, 본문 텍스트에서
  • 간격 → 프로젝트의 간격 스케일 또는 기존 패턴에서
  • 테두리 반경 → 기존 카드, 버튼, 입력 필드에서
  • 그림자 → 기존 그림자 컴포넌트에서

각 변형은 서로 다른 디자인 축을 탐색해야 합니다. 사소한 변형을 만들지 말고 의미 있게 구별되도록 하십시오. 모든 변형에 프로젝트의 기존 시각적 언어를 사용하십시오.

변형 A: 정보 계층 구조 초점

  • 콘텐츠 계층 구조 재구성 (가장 중요한 것은?)
  • 게슈탈트 근접성 적용 — 관련 항목을 더 가깝게 그룹화
  • 뷰당 하나의 주요 작업
  • 기존 타이포그래피 스케일을 사용하여 명확한 수준 생성

변형 B: 레이아웃 모델 탐색

  • 다른 레이아웃 접근 방식 시도 (카드 vs 리스트 vs 테이블 vs 분할 창)
  • DESIGN_PRINCIPLES의 카드 구조 또는 테이블 동작 패턴 적용
  • 각 중단점에서 반응형 동작 고려
  • 프로젝트의 기존 그리드/레이아웃 시스템 사용

변형 C: 밀도 변형

  • 브리프가 "편안한"이면 더 조밀한 버전 시도
  • 브리프가 "조밀한"이면 더 여유로운 버전 시도
  • 프로젝트의 기존 간격 토큰을 사용하되 다르게 적용
  • 트레이드오프 보여주기: 더 많은 데이터 표시 vs 더 쉬운 스캔

변형 D: 상호작용 모델

  • 다른 상호작용 패턴 (모달 vs 인라인 vs 패널 vs 드로어)
  • 피드백 패턴 적용: 즉시 → 진행 중 → 완료
  • 필요한 모든 상태 구현 (로딩, 오류, 빈 상태, 비활성화)
  • 비파괴적 작업의 경우 낙관적 업데이트 고려

변형 E: 표현 방향

  • 인터뷰에서 사용자가 설명한 브랜드 방향 밀어내기
  • 프로젝트의 기존 디자인 토큰을 다르게 사용하는 방법 탐색
  • 그림자, 테두리, 배경색의 사용 정도 조절
  • 의미를 더하는 곳에 모션 적용 (호버, 포커스, 전환)

랩 페이지 요구 사항

디자인 랩 페이지에는 다음이 포함되어야 합니다:

  1. 헤더에 다음 포함:

    • 디자인 브리프 요약 (대상, 범위, 주요 요구 사항)
    • 검토를 위한 지침
  2. 변형 그리드에 다음 포함:

    • 명확한 라벨 (A, B, C, D, E)
    • 각 변형에 대한 간단한 설명 ("왜 이것이 존재하는가")
    • 실제 렌더링된 변형

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

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

Best practices and example-driven guidance for building SwiftUI views and components. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens, or needing component-specific patterns and examples.

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

관련 스킬