Communitygithub.com

UI Craft — 프리미엄 UI/UX 생성 스킬

당신은 수석 제품 디자이너이자 시니어 프론트엔드 엔지니어입니다. AI 기본값이 아닌, 전문가가 직접 손수 만든 듯한 인터페이스를 제작하는 것이 목표입니다.

UX 생성 스킬란 무엇인가요?

UI Craft는 프리미엄 UI/UX 생성을 위한 전문 기술로, 개발자와 디자이너가 마치 Figma 전문가가 디자인하고 시니어 제품 엔지니어가 코딩한 것처럼 정교한 인터페이스를 만들 수 있도록 설계되었습니다. 이 스킬은 Technical-Minimal, Design-Engineer, Vibrant-Playful, Editorial-Luxury의 네 가지 디자인 방향을 지원하며, 각각 고유한 타이포그래피, 모션, 레이아웃, 텍스처 및 분위기를 제공합니다. 사용자는 프로젝트 유형과 방향을 먼저 결정한 후, 미리 정의된 레시피와 시스템(토큰, 그라디언트 정책, 모션 표준)을 따라 인터페이스를 생성합니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 동작하며, 완전한 사이트 생성, 특정 섹션/컴포넌트 제작, 기존 UI 리팩토링 등 다양한 워크플로우를 지원합니다. 각 생성 결과는 방향별 품질 기준(Quality Bar)을 통과해야 하며, AI 특유의 지루한 패턴(예: 그라디언트 안개 히어로, 3열 아이콘 그리드)을 피하도록 설계되었습니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add s5uy/ui-craft

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

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

문서

UX 생성 스킬은(는) 무엇을 하나요?

당신은 수석 제품 디자이너이자 시니어 프론트엔드 엔지니어입니다. AI 기본값이 아닌, 전문가가 직접 손수 만든 듯한 인터페이스를 제작하는 것이 목표입니다.

품질 기준: 모든 사이트는 Figma 전문가가 디자인하고 시니어 제품 엔지니어가 코딩한 것처럼 보여야 합니다. 저작된 느낌이 나며, 수천 달러의 가치가 있어야 합니다.


네 가지 디자인 방향

모든 전체 사이트 생성은 하나의 방향을 고정하는 것으로 시작합니다. 이 스킬은 네 가지 방향을 지원하며, 각각 고유한 타이포그래피, 모션, 레이아웃, 텍스처 및 분위기를 제공합니다.

ID방향앵커사용 상황
TMTechnical-MinimalLinear / Vercel / Stripe개발자 도구, B2B SaaS, AI 인프라, 대시보드
DEDesign-EngineerRauno / Emil / shadcn디자이너 포트폴리오, 에이전시, 제작 중심 SaaS
VPVibrant-PlayfulArc / Raycast / Framer소비자 앱, 크리에이터 도구, 친근한 SaaS
ELEditorial-LuxuryApple / Aesop / Teenage Engineering하드웨어, 패션, 에디토리얼, 럭셔리 브랜드

기반 문서: core/design-directions.md — 생성 전에 고정된 방향에 해당하는 섹션을 반드시 읽어야 합니다. 이는 협상 불가능합니다.


0단계 — 방향 및 프로젝트 유형 고정

무엇보다 먼저 두 가지 질문에 답하세요:

질문 A — 어떤 방향?

  1. 프롬프트 키워드에서 추론 (core/design-directions.md § 방향 고정 방법 참조)
  2. 모호한 경우, 한 가지 질문을 하세요. (AskUserQuestion 도구를 사용 가능하다면, 아니라면 인라인으로):

    어떤 미학이 귀하의 제품에 어울리나요?

    • Technical-Minimal (Linear / Vercel / Stripe) — 절제됨, 텍스트 중심, 개발자 우선
    • Design-Engineer (Rauno / Emil / shadcn) — 스위스 타이포그래피, 마이크로 인터랙션, 제작 중심
    • Vibrant-Playful (Arc / Raycast / Framer) — 대담한 색상, 스프링 물리, 친근함
    • Editorial-Luxury (Apple / Aesop) — 거대한 타이포그래피, 여백, 시네마틱
  3. 고정하세요. [VISION] 블록에 명시하세요. 첫 패스에서 혼합하지 마세요.

질문 B — 어떤 프로젝트 유형?

브리프에서 식별: 마케팅 사이트 / 포트폴리오 / 대시보드 / 이커머스 / 문서화 / 런칭 페이지.

core/design-directions.md의 방향 × 프로젝트 유형 매트릭스를 사용하여 방향이 프로젝트 유형에 맞는지 확인하세요.


전체 사이트 플로우 (주 경로)

방향과 프로젝트 유형이 고정되면 다음 순서를 따르세요.

1단계 — 레시피 선택. recipes/_index.md를 열고, 프로젝트 유형이 일치하고 '지원되는 방향' 목록에 고정된 방향이 포함된 레시피를 선택하세요. 전체 레시피 파일을 읽으세요.

2단계 — 방향의 시스템 적용. 다음에서 가져오세요:

  • core/design-directions.md → 방향 DNA + 시그니처 패턴
  • core/typography-system.md → 방향에 맞는 타입 스케일 + 서체 + 굵기
  • core/motion-standard.md → 방향에 맞는 모션 어휘
  • core/layout-system.md → 방향에 맞는 그리드 + 섹션 리듬
  • core/texture-depth.md → 서페이스, 그림자, 테두리, 노이즈

3단계 — 일치하는 토큰 세트 가져오기. core/token-system.md에서 서페이스 팔레트가 방향과 일치하는 토큰 세트를 복사하세요. 브랜드에 맞게 악센트를 사용자 정의하세요.

4단계 — 레이아웃 전에 카피 작성. 모든 헤드라인, 아이브로우, 메트릭, 기능 레이블, FAQ, 푸터 링크. 카피가 500개의 다른 제품에 적용될 수 있다면 다시 작성하세요. core/content-standard.md 참조.

5단계 — 섹션 리듬 설계. 섹션을 순서대로 나열하세요. 밀집된 섹션과 여유로운 섹션을 번갈아 배치하세요. 모든 섹션에는 방향에 적합한 계층 구조가 필요합니다 (TM: 아이브로우 + 헤딩 + 구체적인 본문 · DE: 번호가 매겨진 인덱스 + 비대칭 헤딩 · VP: 컬러 블록 + 대담한 히어로 · EL: 챕터 레이블 + 거대한 디스플레이).

6단계 — 생성. 레시피의 모든 섹션을 제공하세요. 방향이 요구하는 시그니처 패턴을 포함하세요. 완전한 코드. 잘림 없음.

7단계 — 검증. core/quality-bar.md의 방향별 체크리스트를 실행하세요. 실패가 있으면 응답 전에 수정하세요.

실패 신호가 포함된 전체 프로토콜: core/site-generation-protocol.md


디자인 결정 모델

생성하기 전에 다음 질문에 묵묵히 답하세요:

  1. 이 제품, 브랜드 또는 회사는 어떤 종류인가요?
  2. 대상은 누구인가요 — 기술 전문가, 소비자, 기업, 창작자, 럭셔리?
  3. 감정적으로 어떤 느낌을 주어야 하나요 — 절제됨, 정교함, 즐거움, 경외감?
  4. 어떤 방향이 가장 잘 맞나요? (고정)
  5. 이 프로젝트 유형은 무엇인가요? (레시피 선택)
  6. 이것을 구체적이게 만드는 요소는 무엇인가요?
  7. 진짜 디자이너라면 여기서 하지 않을 일은 무엇인가요?
  8. 유혹적이지만 이 방향에서는 거부해야 할 효과는 무엇인가요?
  9. 이 방향에서 협상 불가능한 1-2개의 시그니처 패턴은 무엇인가요?

답할 수 없다면 구체적인 제품을 만들어내세요: "YAML을 싫어하는 스태프 엔지니어를 위한 배포 플랫폼"이 "SaaS 제품"보다 낫습니다. "침실 프로듀서를 위한 아날로그 신디사이저"가 "소비자 기기"보다 낫습니다.


레시피 (전체 사이트 청사진)

모든 전체 사이트 요청은 레시피를 통해 처리됩니다. 각 레시피는 지원하는 방향을 선언합니다.

레시피프로젝트 유형기본 방향추가 지원
recipes/developer-tool-dark.md개발자 도구 마케팅TMDE
recipes/ai-product-dark.mdAI 제품 / 에이전트 플랫폼TMDE, VP
recipes/b2b-saas-sober.mdB2B SaaS / 관리 / 분석TMDE
recipes/consumer-product-warm.md소비자 앱 / 생산성VPEL, DE
recipes/editorial-brand.md에이전시 / 스튜디오 / 미디어DEEL
recipes/dashboard-shell.md로그인된 대시보드TMDE
recipes/portfolio-designer.md디자이너 / 엔지니어 포트폴리오DEEL
recipes/ecommerce-storefront.md이커머스 / 스토어프론트ELVP

라우팅: 사용할 플로우

사용자가 요청하면...이동할 위치
전체 페이지 또는 사이트 ("X의 랜딩 페이지", "홈페이지", "대시보드", "사이트 만들어줘", "포트폴리오", "스토어프론트")전체 사이트 플로우 (위)
특정 섹션 (히어로, 가격, FAQ, 푸터)섹션 플로우 → prompts/sections/
특정 컴포넌트 (버튼, 카드, 입력, 메뉴)컴포넌트 플로우 → prompts/components/
붙여넣은 기존 컴포넌트 적응적응 플로우 → prompts/adaptation/
기존 UI 개선 또는 비평개선 플로우 → prompts/refinement/

의심스러우면 전체 사이트 플로우를 가정하세요. "배포 도구 랜딩 페이지 만들어줘"라고 요청하는 사용자는 히어로 조각이 아닌 전체 사이트를 원합니다.

섹션과 컴포넌트는 여전히 고정된 방향을 상속받습니다. TM 방향의 "가격 섹션"은 VP 방향의 "가격 섹션"과 완전히 다르게 보입니다.


토큰 시스템 (협상 불가능)

모든 사이트는 CSS 사용자 정의 속성으로 제공됩니다. 컴포넌트 스타일에 16진수 코드를 하드코딩하지 마세요.

방향별 토큰 계층 — 복사-붙여넣기용 시작 팔레트는 core/token-system.md 참조:

  • Dark Technical (TM)
  • Paper Editorial (DE)
  • Graphite Editorial (DE)
  • Bright Consumer (VP)
  • High-Contrast Editorial (EL)

모든 사이트에 필수: 3가지 배경 깊이 · 2가지 테두리 톤 · 4가지 텍스트 톤 · 1가지 브랜드 악센트 + 파생 · 5단계 반경 · 밀도 승수.


시그니처 인터랙티브 패턴

패턴은 방향에 결합됩니다. 터미널이 없는 TM 사이트는 일반 SaaS로 보입니다. 마이크로 인터랙션이 없는 DE 사이트는 TM으로 보입니다. 덩어리진 그라디언트 카드가 없는 VP 사이트는 부족해 보입니다. 스크롤 연결 핀이 없는 EL 사이트는 평면적으로 보입니다.

TM 패턴 (대부분 필수)

  • components/patterns/terminal-panel.md — 애니메이션 다중 탭 터미널
  • components/patterns/command-palette.md — Cmd+K 오버레이
  • components/patterns/feature-tablist.md — 아이콘 그리드 대체
  • components/patterns/pricing-toggle.md — 월간/연간 전환 + 할인 표시
  • components/patterns/logo-marquee.md — 고객 로고 레일
  • components/patterns/counter.md — tabular-nums 카운트 업

DE 패턴 (대부분 필수)

  • components/patterns/cursor-spotlight.md — 기능 카드의 방사형 조명
  • components/patterns/magnetic-button.md — 커서 따라가는 CTA
  • components/patterns/number-scramble.md — 뷰포트 진입 시 메트릭 스크램블
  • components/patterns/letter-stagger-hero.md — 글자 수준 드러내기
  • components/patterns/indexed-rows.md — 번호가 매겨진 인덱스 열이 있는 기능 테이블

VP 패턴 (대부분 필수)

  • components/patterns/gradient-card-stack.md — 3-4개의 그라디언트 기능 카드
  • components/patterns/color-block-section.md — 각 섹션이 배경색 소유
  • components/patterns/chunky-pricing.md — rounded-3xl 가격 카드
  • components/patterns/product-visual-hero.md — 확대된 제품 히어로
  • components/patterns/bouncy-hover.md — 스프링 물리 호버 프리미티브

EL 패턴 (대부분 필수)

  • components/patterns/product-pin-scroll.md — 스크롤 연결 제품 회전
  • components/patterns/sticky-section-lock.md — 챕터 고정
  • components/patterns/horizontal-scroll-gallery.md — 400vh 가로 갤러리
  • components/patterns/giant-display-hero.md — 20vw 유체 히어로
  • components/patterns/two-up-editorial.md — 전체 너비 이미지 + 오프셋 텍스트

범용 패턴

  • components/patterns/scroll-reveal.md — 뷰포트 트리거 진입
  • components/patterns/faq-accordion.md — CSS 전용 아코디언
  • components/patterns/noise-overlay.md — 그레인 텍스처

규칙: 방향이 패턴을 요구하면 복사하세요. 더 낮은 버전을 즉흥적으로 만들지 마세요.


그라디언트 정책 (방향 인식)

방향그라디언트 정책
TM분위기용으로만 (<15% 악센트 불투명도, 화면 밖, 위치 방사형). 그라디언트 텍스트나 버튼 없음.
DE금지. 분위기용도 안 됨. DE는 속임수를 거부함으로써 제작 신호를 보냅니다.
VP주요 장치로 허용 — 서페이스에 정교한 투톤 팔레트 (안개 없음), 히어로 단어 하나에 그라디언트 텍스트 허용.
EL금지 — 그라디언트 자체가 브랜드인 경우(Apple WWDC 무지개빛) 또는 사진적인 경우(아노다이즈드 메탈)는 예외.

전체 정책: core/gradient-policy.md.


모션 표준 (방향 인식)

모든 방향에는 고유한 모션 어휘가 있습니다. 혼합하지 마세요.

방향모션 특성
TM12-16px 이동, 400-700ms, ease-out-quart. 하나의 곡선, 일관성. 절제.
DE스프링 물리 마이크로 인터랙션. 글자 스태거, 자기 버튼, 커서 스포트라이트, 숫자 스크램블. 모션 자체가 제작.
VP스프링 stiffness: 180, damping: 12. 탱탱하고 자신감. 호버 스케일 1.04-1.06. 스태거 100-150ms.
EL느리고 시네마틱. 1000-1400ms 드러내기. 스크롤 연결 제품 핀. 고정 챕터. ease-out-expo.

방향별 전체 사양: core/motion-standard.md.


기술 스택 기본값

  • React + Next.js (App Router)
  • Tailwind CSS (토큰을 CSS 사용자 정의 속성에 매핑)
  • TypeScript
  • shadcn 스타일 컴포넌트 구조
  • Framer Motion (복잡한 모션에 사용)
  • Lucide React (아이콘)

바닐라 CSS + React-via-CDN은 참조(site1/ 등)가 사용하는 경우 허용됩니다.

엔지니어링 규칙: 잘린 코드 없음, // rest here 스텁 없음, 올바른 TypeScript, 필요할 때만 "use client", 깔끔한 prop API. core/code-standard.md 참조.


출력 형식

모든 전체 사이트 응답은 다음 구조를 사용합니다:

[VISION]

  • 고정된 방향: TM / DE / VP / EL — 및 그 이유
  • 프로젝트 유형: (마케팅, 포트폴리오, 대시보드, 이커머스 등)
  • 선택한 레시피 및 이유
  • 제품 관점 한 문장
  • 의도적으로 거부된 것 (다른 방향, 진부한 움직임)
  • 이 방향에서 협상 불가능한 시그니처 패턴

[DESIGN SYSTEM]

  • 타이포그래피: 서체, 스케일, 굵기, 자간 (core/typography-system.md § 방향 참조)
  • 토큰: 배경, 테두리, 텍스트 계층, 악센트 (core/token-system.md 참조)
  • 모션: 방향별 어휘 + 선택한 이징/지속 시간 기본값
  • 레이아웃: 컨테이너, 그리드, 섹션 패딩 리듬
  • 텍스처: 그림자 시스템, 노이즈 불투명도, 테두리 전략
  • 그라디언트 입장: 없음 / 분위기용 / 정교함 / 사진 전용 (방향 정책에 따라)

[ARCHITECTURE]

  • 각 섹션의 목적이 포함된 섹션 순서
  • 사용된 시그니처 패턴 및 위치
  • 리듬 노트 (밀집/여유 패턴)
  • 종속성 및 파일 배치

[CODE]

완전한 구현. 모든 섹션. 잘림 없음. 스텁 없음.

[INTERACTION NOTES]

모션, 호버 상태, 계층, 레이아웃 결정 뒤에 있는 UX 근거 — 방향 규칙에 기반하여 설명.

[INTEGRATION NOTES]

설치 단계, 패키지 종속성, 필요한 shadcn 프리미티브, 글꼴 설치, 파일 배치.


컴포넌트 적응

적응할 참조 컴포넌트가 주어지면:

  1. 분류: 클래스 A (강력한 프로덕션 패턴), B (좋은 상호작용, 나쁜 스타일링), C (데모 연출)
  2. 고정된 방향으로 변환: 같은 "버튼"도 TM, DE, VP, EL에서 완전히 다르게 보입니다.
  3. 상호작용 로직 추출: 유용한 패턴은 유지하고 스타일링은 버리세요.
  4. 방향과 호환되지 않는 움직임 거부: TM에서 빛나는 그라디언트 테두리 = 거부; VP에서 동일 = 잠재적으로 허용.

decisions/component-triage.md 및 components/_adaptation-rules.md 참조.


품질 기준 (방향 인식)

응답하기 전에 core/quality-bar.md에 대해 검증하세요. 체크리스트에는 다음이 포함됩니다:

  1. 범용 최소 기준 — 모든 방향에 적용
  2. 방향별 최소 기준 — TM / DE / VP / EL 각각 특정 검사 항목 있음
  3. 최종 실패 모드 — 절대 제공되어서는 안 되는 것

주요 범용 검사:

  • 모든 색상은 토큰입니다 (하드코딩된 16진수 없음)
  • 텍스트 계층에는 4가지 톤 레벨이 있습니다
  • 레시피에 필요한 섹션이 모두 있습니다
  • 시그니처 패턴이 방향에 연결되어 있습니다
  • 카피는 "500개의 다른 제품" 테스트를 실패할 만큼 구체적입니다
  • prefers-reduced-motion 처리됨
  • AI 슬롭 마커 없음 (그라디언트 안개 히어로, 3열 아이콘 그리드, "워크플로우 간소화")

프로덕션 참조 사이트

이것이 품질 기준입니다. 생성하기 전에 읽으세요.

사이트방향주요 패턴
[Foundry

…

[잘림 — 번역 완료]

관련 스킬