Communitygithub.com

디자인 크래프트

에이전트가 랜딩 페이지, 홈페이지 또는 포트폴리오를 아트 디렉션하고 구축하는 방법을 안내합니다. 디자인 크래프트, 필요의 순서, 1. 프레임(코드 작성 전) 단계를 거치며, 이 크래프트가 필요한 새로운 과제가 있을 때 사용합니다.

디자인 크래프트란 무엇인가요?

이 스킬은 프론트엔드 디자인 및 구축을 위한 체계적인 작업 방법을 제공하며, 특히 랜딩 페이지, 홈페이지, 포트폴리오와 같은 시각적 결과물에 중점을 둡니다. '디자인 크래프트'는 단순한 스타일링 이상의 의미를 가지며, 기능성, 신뢰성, 사용성, 그리고 즐거움이라는 순차적 니즈를 충족시키는 것을 목표로 합니다. 에이전트는 코드 작성 전에 작업을 프레이밍하고, 주제의 시그니처를 찾으며, 저렴하게 탐색하고, 시스템을 먼저 구축한 후, 모든 상태를 고려하고, 감정과 정직성을 담으며, 모션을 추가하고, 마지막으로 실제 브라우저에서 검증하는 8단계 프로세스를 따릅니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 활용할 수 있도록 설계되었으며, 각 단계에 대한 상세한 참조 파일(references/)을 제공하여 깊이 있는 이해와 구현을 지원합니다. 이 스킬은 '기능적 → 신뢰할 수 있는 → 사용 가능한 → 즐거운' 순서의 니즈를 강조하며, 고장나거나 느리거나 혼란스러운 요소에 단순히 시각적 즐거움을 덧붙이지 않도록 주의합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Iitian001/design-craft/tree/HEAD/skills/design-craft

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

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

문서

디자인 크래프트은(는) 무엇을 하나요?

프론트엔드 디자인 및 구축을 위한 작업 방법입니다. SKILL.md는 모든 작업에 필요한 내용을 담고 있으며, references/ 파일은 심화 내용, 수치 및 코드를 제공합니다. 마지막 표의 트리거가 적용될 때 해당 파일을 읽으세요.

범위: 새로운 페이지, 흐름 또는 컴포넌트는 1-8단계를 실행합니다. 작은 변경(상태 하나, 애니메이션 하나, 문자열 하나)은 해당 단계만 실행한 후 변경된 부분에 대해 8단계를 실행합니다.

필요의 순서

기능적 → 신뢰할 수 있는 → 사용 가능한 → 즐거운. 고장나거나, 느리거나, 혼란스러운 것에 즐거움을 더하지 마세요. 또한 최상위 레이어 없이 배송하지 마세요: 나중으로 미뤄진 개성은 거의 배송되지 않습니다.

1. 프레임 (코드 작성 전)

  • 직무 스토리: [상황]일 때, [동기]를 위해 [결과]를 얻고 싶다. 상황이나 결과를 모르면 질문하거나, 요약에서 가정을 가설로 명시하세요.
  • 브리핑이 요구하는 야망을 선택하고, 그곳에 노력을 집중하세요:
브리핑투자할 부분첫 번째 증명
브랜드 사이트, "프리미엄", "수상 수준", "애니메이션 가득"주제에 기반한 하나의 시그니처 인터랙션 (2단계)실제 콘텐츠에서 작동하는 인터랙션: 시작, 중간, 중단, 해제
런칭, 에디토리얼, 마케팅 페이지제안이 명확하고 최고의 증거를 탐색할 수 있음휴대폰에서 읽히는 첫 화면; 대기 없이 주요 작업에 도달 가능
앱, 도구, 대시보드가장 어려운 결정, 실수 비용, 반복 사용 속도데이터가 변화하는 현실적인 작업 + 하나의 실패 복구
컴포넌트 또는 디자인 시스템두 가지 다른 소비자를 견디는 행동 계약긴 콘텐츠를 가진 두 맥락에서의 동일한 컴포넌트
  • 사실과 가정을 분리하세요. 도착 시 방문자의 감정 상태를 명명하세요; 분위기를 결정합니다.
  • 기존 토큰, 컴포넌트, 패턴, 규칙을 확인하세요. 발명보다 재사용을 우선시하세요.

2. 주제에서 시그니처 찾기

표현적인 작업의 경우, 방문자가 로고가 가려져도 알아볼 수 있는 주제의 속성과 방문자가 그것을 조종할 수 있는 동사를 찾으세요. 맥주는 따르고, 거품이 일며 색상을 보여줍니다; 직물은 드레이프됩니다; 서체에는 축이 있습니다; 시계에는 무브먼트가 있습니다. 해당 속성을 중심으로 인터랙션을 디자인하세요.

  • 대체 테스트: 관련 없는 브랜드로 바꿔보세요. 효과가 여전히 문제없이 작동한다면, 아직 주제에 관한 것이 아닙니다. 세부 사항을 추가하기 전에 주제로 돌아가세요.
  • 네 박자: 무엇이 입력을 유도하는가 → 접촉 시 무엇이 반응하는가 → 지속적인 입력 아래 무엇이 드러나는가 → 해제 시 무엇이 남는가. 하나의 지속적인 객체가 네 가지를 모두 전달해야 합니다.
  • 더 많은 효과가 "기본적으로 느껴진다"는 문제를 해결하지 않습니다. 대신 중심 아이디어나 메커니즘을 바꾸세요.
  • 모든 제스처에는 동일한 정보에 도달하는 평범한 등가물(슬라이더, 버튼, 라디오 그룹)이 있어야 합니다.

3. 저렴하게 탐색하고, 가장 어려운 부분을 먼저 증명하세요

  • 구조적으로 다른 접근 방식을 최소 세 가지 각각 몇 줄로 설명하세요. 하나를 선택하고 이유를 말하세요.
  • 모션 전에 실제 콘텐츠로 정지 프레임을 구성하세요: 읽기 순서, 타입, 이미지, 주요 작업. 애니메이션 중간의 프레임도 의도적으로 보여야 합니다.
  • 가장 위험한 주장(제스처, 스크롤 장면, 어려운 워크플로우)을 먼저 구축하고, 나머지 페이지를 그 주위에 구축하기 전에 실제 브라우저에서 확인하세요.

4. 시스템 우선

  • 토큰이 컴포넌트보다 먼저입니다. 컴포넌트는 기본 요소(--amber-400)를 별칭하는 의미론적 토큰(--color-action)을 사용합니다. 컴포넌트 스타일 내에 hex, px 또는 매직 넘버를 사용하지 마세요.
  • 4 기반 척도의 간격(4, 8, 12, 16, 24, 32, 48, 64). 본문 16px/1rem, 줄 높이 1.5; 제목 1.1-1.25. 하나의 모듈러 타입 비율. 최대 두 가지 서체(+ 고정폭). 변화하는 숫자에는 표 모양 숫자.
  • 1-3개의 브랜드 색상, 중성색, 상태 색상. 모든 텍스트 쌍은 WCAG AA(본문 4.5:1, 대형/UI 3:1)를 통과해야 합니다. 색상이 유일한 신호가 되어서는 안 됩니다.
  • 모션 토큰(지속 시간, 이징)은 색상 및 간격 옆에 위치합니다.
  • Props는 의미를 이름으로 지정하고(variant="destructive"), 모양이 아닙니다. 반복된 재정의는 누락된 변형을 의미합니다.

5. 모든 상태, 행복한 경로만이 아닙니다

인터랙티브 컴포넌트: 기본, 호버, focus-visible, 활성, 비활성, 로딩, 오류, 선택됨. 화면: 비어 있음, 로딩 중, 부분, 오류, 성공, 오프라인. 비동기 작업:

  • 최신 요청이 우선됩니다; 느린 이전 응답이 최신 응답을 덮어쓰지 않아야 합니다.
  • 실패 후에도 사용자의 입력을 유지하고, 로딩 중에는 이전 결과를 (희미하게) 계속 표시하세요.
  • 빈 계정, 결과 없음, 가져오기 실패는 각각 다른 상태이며 다른 다음 작업이 있습니다.

키보드 조작 가능, 의미론적 HTML 우선, HTML이 표현할 수 없는 경우에만 ARIA, 모든 필드에 레이블, 모든 모달에서 눈에 띄게 빠져나올 수 있는 방법, 모달이 닫힐 때 포커스가 적절한 곳으로 돌아가야 합니다.

6. 감정, 카피 및 정직성

  • 명확함이 재치보다 낫습니다. 농담이 한 문장을 더 필요로 한다면, 삭제하세요. 축약형, 평이한 단어.
  • 목소리는 일정하고, 어조는 변합니다: 성공 시 따뜻하게, 오류 시 평범하고 차분하게, 민감한 입력 시 부드럽게.
  • 오류: 무슨 일이 일어났는지, 왜, 다음에 무엇을 해야 하는지, 그리고 무엇이 유지되었는지. 결코 사용자를 탓하지 마세요. 여기에는 유머가 없습니다.
  • 빈 상태는 초대합니다: 여기에 무엇이 나타날지와 하나의 명확한 첫 번째 작업.
  • 최고점-끝점: 진정한 성취의 끝에 하나의 큰 즐거움을 배치하고, 결코 좌절의 골짜기에 배치하지 마세요.
  • 높은 중요도 페이지에서는 방문자의 두려움을 명명하고 행동 유도 전에 각각에 답하세요.
  • 이미지: 기본적으로 다양한 구성원; "우리가 누구를 배제하고 있는가?"라고 질문하세요.
  • 정직성: 사람들이 실제라고 착각할 수 있는 AI 생성 이미지 및 데모 데이터에 레이블을 붙이세요. 카피는 이미지가 보여주는 것과 일치해야 합니다(5.0%를 출력하는 캔은 페이지에 5.0%라고 표시됨).
  • 규제된 카테고리(알코올, 금융, 건강, 아동): 필요한 게이트나 공개를 추가하고 이미지가 카테고리의 광고 규범을 준수하는지 확인하세요(예: 알코올에 대해 성적 이미지 금지).

7. 모션

모든 애니메이션에는 작업이 있습니다: 맥락, 주의, 피드백 또는 개성. 작업이 없으면 애니메이션도 없습니다.

토큰값사용
--dur-1100ms누름, 포커스, 토글 (≈ 지각적 최소치)
--dur-2200ms대부분의 UI 전환, 호버, 작은 입장
--dur-3300ms패널, 서랍, 모달
--dur-4400-500ms전체 화면 또는 히어로 안무 전용
--ease-outcubic-bezier(0,0,.2,1)들어가기 / 주의 얻기
--ease-incubic-bezier(.4,0,1,1)떠나기 / 주의 잃기 (퇴장은 ~20-30% 더 짧게)
--ease-in-outcubic-bezier(.4,0,.2,1)화면 내 위치 사이 이동
spring임계 감쇠, 재타겟 가능제스처; 대상이 변경될 때 속도 유지
  • 주요 작업을 안무로 차단하지 마세요. 프리로더나 인트로는 약 1초 이상 주요 작업을 보류해서는 안 되며, 재방문자는 건너뜁니다.
  • 공간적 일관성: 사물은 온 방향으로 떠나고; 공유 요소는 제자리에서 변형됩니다.
  • 스태거 30-60ms, 감쇠 지연(base*√i) 사용; 전체 시퀀스를 ~300ms 이내로 유지하세요.
  • 스크롤 장면: 진행률은 섹션의 측정된 이동에 매핑되므로, 동일한 스크롤 위치는 항상 동일한 프레임을 제공하고, 위로 스크롤하면 깨끗이 역전되며, 중간에 대한 직접 링크가 작동합니다.
  • 제스처: 진행률의 소유자는 하나; 그립은 포인터에 붙어 있어야 함; 해제 시 속도를 스프링에 위임; 비행 중 중단은 UI를 작동 가능하게 유지합니다.
  • transform과 opacity만 애니메이션하세요. prefers-reduced-motion에서는 이동, 시차, 확대/축소 및 자동 재생을 제거하고 짧은 페이드는 유지하며, 사용자 주도 제스처는 계속 작동하게 하세요.
  • 실제 빌드를 망가뜨린 엔지니어링 함정 (속성 하나, 소유자 하나; 일시 중지된 스크롤 타임라인; 타임라인 내부의 스냅 레이블; 음수가 아닌 프레임 시간; 교체 가능한 에셋 사전 로딩): references/motion-engineering.md.

8. 실제 브라우저에서 확인한 후, 인계

scripts/walk.py (Playwright + 로컬 Chrome)를 데스크톱, 휴대폰 및 축소 모션에서 실행하세요: 실제 포인터 드래그, 모든 섹션 스크롤, 콘솔 오류, 가로 방향 오버플로우. 숨겨지거나 최소화된 미리보기 창은 애니메이션 프레임을 조절하므로, 그 창에서 모션을 판단하지 마세요. 세부 사항: references/verification.md.

그런 다음 취향이 아닌 직무 스토리에 대해 비판하세요:

  1. 직무 스토리를 충족합니까? 주요 작업이 가장 눈에 띄고 모든 곳에서 접근 가능합니까?
  2. 모든 상태가 존재합니까 (5단계)? 키보드, 스크린 리더 레이블, 대비?
  3. 토큰만 사용됩니까? 기존 컴포넌트가 재사용됩니까?
  4. 카피가 6단계(정직성 레이블 포함)를 따릅니까?
  5. 모든 애니메이션에 작업, 올바른 이징 방향, 중단 경로 및 축소 모션 경로가 있습니까?
  6. 시그니처가 대체 테스트를 통과합니까? 끝에 배치된 하나의 최고점이 있습니까?
  7. 무엇을 잘라낼까요? 하나의 요소나 효과를 제거하고 개선되는지 확인하세요.

근거와 함께 인계하세요: 문제, 접근 방식, 거부된 대안 및 그 이유, 테스트된 내용 및 방법(에뮬레이션 대 실제 장치), 알려진 한계. 템플릿: references/process-and-teams.md 부록 B.

참조

읽을 파일시기
references/motion-engineering.mdGSAP/ScrollTrigger/Lenis, 캔버스, 제스처 또는 스크롤 장면 작업 구축 시
references/verification.md시각적 또는 인터랙티브 작업 완료를 선언하기 전
references/imagery.md이미지 생성 또는 준비, 제품 컷아웃, 아트 디렉션 시
references/animation.md안무, 7가지 모션 원칙, 스태거 수학, 모션 토큰 관련
references/emotion.md디자인 페르소나, 온보딩, 즐거움, 신뢰 및 두려움, 중단 복사본 관련
references/design-systems.md토큰, 컴포넌트 API, 거버넌스, 버전 관리, 문서 관련
references/product-design.md리서치, 스토리 우선, 스케치, 피드백, 프로토타이핑, 테스트 관련
references/design-thinking.md공감/정의/아이데이션/프로토타입/테스트가 필요한 모호한 문제 관련
references/design-engineering.md프로토타입 충실도 선택, 디자인↔코드 핸드셰이크 관련
references/process-and-teams.md비판 세션, 근거 및 인계 템플릿, DesignOps 관련

관련 스킬