Communitygithub.com

디자이너

페이지, 스크린, 랜딩 페이지 또는 대시보드의 레이아웃과 계층 구조를 비평하거나, 재설계하거나, 검토할 때 사용합니다. "디자인이 이상하다", "평범해 보인다", "AI가 만든 것처럼 보인다"는 피드백에도 사용합니다. 토큰, 팔레트, 타입 스케일에는 사용하지 않습니다. 시각 디자인은 별도 스킬을 사용하세요.

디자이너란 무엇인가요?

디자이너(Designer) 스킬은 실제 페이지에 디자인 시스템을 적용하여 사용자에게 세심하게 고려된 느낌을 주거나, 원래 의도에서 벗어난 페이지를 재설계하는 AI 에이전트 스킬입니다. 이 스킬은 레이아웃과 계층 구조를 결정하고, 렌더링된 페이지에서 이를 검증하는 데 중점을 둡니다. 페이지의 의도(Intent)를 한 문장으로 정의하는 것부터 시작하여, 현재 페이지를 감사(Audit)하고, 구조(Structure)와 계층(Hierarchy)을 분석한 후 와이어프레임(Wireframe)을 통해 색상 없이 구조를 검증합니다. 그런 다음 색상, 타입, 레이아웃, 시그니처 요소로 구성된 방향(Direction)을 확정하고, 시각 디자인 시스템을 적용하며, 최종적으로 렌더링된 페이지를 다양한 뷰포트(375px, 전체 너비)에서 스크린샷으로 검증하고 접근성 체크를 수행합니다. 이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, 마케팅(브랜드), 제품(대시보드), 콘텐츠(문서) 표면 레지스터(Surface Register)에 따라 디자인 결정을 달리해야 한다는 점을 강조합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/heliacon/claude-skills/tree/HEAD/skills/designer

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

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

문서

디자이너은(는) 무엇을 하나요?

실제 페이지에 디자인 시스템을 적용하여 사람이 세심하게 고려되었다고 느끼게 하고, 원래 의도에서 벗어난 페이지를 재설계합니다. visual-design 스킬은 시스템(토큰, 스케일, 컴포넌트 명세)을 구축합니다. artist 스킬은 이미지를 만듭니다. copywriter 스킬은 글을 작성합니다. 이 스킬은 어떤 요소가 어디에, 왜 배치되어야 하는지 결정하고, 렌더링된 페이지에서 이를 입증합니다.

가장 중요한 규칙

  1. 의도를 먼저 작성하세요. 한 문장으로: 이 페이지가 누구를 위한 것이며, 사용자가 반드시 하거나 이해해야 할 단 한 가지는 무엇인지. 쓸 수 없다면 디자인할 수 없습니다.
  2. 절대 스타일부터 바꾸지 마세요. 감사(Audit), 구조(Structure), 계층(Hierarchy)이 색상보다 우선입니다. 대부분의 재설계는 주로 제거(Subtraction)입니다.
  3. 코드가 아닌 렌더링된 페이지를 판단하세요. 375px와 전체 너비에서 열고, 스크린샷을 찍어 확인하세요. 출력 결과를 보지 않은 에이전트는 추측하는 것입니다.
  4. 뷰(View)당 하나의 기본 액션(Primary Action). 두 가지가 동시에 외치면 아무것도 들리지 않습니다.
  5. CSS를 작성하기 전에 방향(Direction)을 확정하고 중앙값 검사(Median Test)를 수행하세요. (아래 참조)
  6. 표면 레지스터(Surface Register)(브랜드, 제품 또는 콘텐츠)를 모든 크래프트 결정보다 먼저 결정하세요. 같은 장식도 어떤 표면에서는 적절하고, 다른 표면에서는 버그입니다.

사용하지 말아야 할 경우

  • 토큰, 램프(Ramps), 타입 스케일, 다크 모드 리맵(Remaps) 또는 컴포넌트 상태 명세 정의: visual-design.
  • 일러스트레이션, 아이콘, 히어로 이미지, 마크(Marks) 또는 다이어그램 생성 또는 지시: artist.
  • 헤드라인, 클릭 유도 문구(Call to Action) 또는 마이크로카피 작성: copywriter. 이 스킬은 카피가 어디에 위치하고 얼마나 많은 공간을 차지할지 결정합니다.
  • 사이트 전체 내비게이션 및 분류(Taxonomy): information-architecture.
  • 컴포넌트 및 상태 관리의 구현 세부 사항: frontend.

재설계 프로세스

  1. 의도(Intent). 위에서 언급한 한 문장.
  2. 첫인상(First impression). 아무것도 읽기 전에, 현재 페이지를 2초 동안 보세요. 무엇이 눈에 띄었는지 적습니다: 가장 먼저 본 것, 두 번째로 본 것, 그리고 페이지가 무엇을 위한 것이라고 생각하는지. 그것이 낯선 사람이 받는 인상입니다.
  3. 감사(Audit). 모든 블록과 그 역할을 나열합니다. 각각 유지(Keep), 제거(Cut), 이동(Move) 또는 병합(Merge)으로 표시합니다.
  4. 구조(Structure). 어떤 콘텐츠가 이 페이지에 속하고 어떤 콘텐츠가 다른 페이지에 속하는지 결정합니다. 페이지는 입구(Entrance)이지 창고(Warehouse)가 아닙니다. ("콘텐츠 분배" 참조)
  5. 계층(Hierarchy). 남은 블록의 순위를 정합니다: 첫 번째, 두 번째, 세 번째로 봐야 할 것.
  6. 와이어프레임(Wireframe). 회색조(Greyscale)만 사용한 블록과 계층. 색상 없이 구조가 작동하는지 입증합니다.
  7. 방향(Direction). 아래 네 줄을 확정합니다.
  8. 시스템 적용(Apply the system). visual-design의 토큰, 타입 역할, 간격, 컴포넌트.
  9. 에셋(Assets). artist를 통해 이미지를 지시합니다.
  10. 렌더, 비평, 수정(Render, critique, fix). "렌더 및 검증"의 루프를 체크리스트가 통과할 때까지 반복합니다. 그런 다음 하나를 더 제거합니다.

방향 확정하기

CSS를 작성하기 전에 결정할 네 줄:

  • 색상(Colour): 4~6개의 명명된 값과 각각의 역할.
  • 타입(Type): 디스플레이(Display), 본문(Body), 유틸리티(Utility) 역할에 사용할 서체(Faces).
  • 레이아웃(Layout): 각 주요 뷰의 한 문장 설명과 텍스트 와이어프레임.
  • 시그니처(Signature): 페이지에서 기억될 단일 요소. 대담함(Boldness)은 거기에 집중하고 주변은 조용하게 유지하세요.

그런 다음 중앙값 검사(Median Test): 유사한 브리핑에도 이와 동일한 디자인을 내놓을 것인가? 그렇다면 디자인이 아니라 기본값(Default)입니다. 주제로 돌아가서 그 주제에 특화된 것(재료, 문서, 도구, 시대)을 찾고 시그니처를 그에 맞게 형성하세요.

생성 디자인의 특징 (반사적으로 피할 것)

  • 아무도 선택하지 않아서 선택된 기본 서체(Inter, Roboto, Arial, Space Grotesk).
  • 큰 숫자, 작은 레이블, 그라데이션 악센트(콘텐츠가 하나의 숫자가 아닐 때).
  • 순차적이지 않은 콘텐츠에 01 / 02 / 03 마커 사용.
  • 각각 아이콘, 제목, 두 줄 텍스트가 있는 동일한 카드 그리드.
  • 글라스모피즘(Glassmorphism), 그라데이션 텍스트, 카드의 컬러 사이드 스트라이프, 작은 대문자 눈썹(Eyebrow).
  • 모든 항목에 채워진 눈썹 또는 태그 슬롯. 항상 존재하는 레이블은 정보를 전달하지 않습니다. 눈썹을 유지한다면, 그것은 상위 섹션의 이름을 나타냅니다.
  • 크림색 페이지, 세리프 디스플레이, 테라코타 악센트; 또는 하나의 산(Acid) 악센트가 있는 거의 검은색.

이것들은 생성 디자인에서 흔한 기본값들입니다. 각각 자체로 잘못된 것은 아닙니다. 아무도 결정하지 않았을 때 잘못된 것입니다.

표면 레지스터

  • 브랜드 표면(마케팅, 랜딩, 런칭): 디자인이 제공(Offer)의 일부입니다. 표현적이고, 여유로운 공간, 하나의 기억에 남는 시그니처. 모션(Motion)은 그 자리를 얻을 수 있습니다.
  • 제품 표면(앱, 대시보드, 설정): 디자인은 작업(Work)을 위한 것입니다. 밀도 높고, 조용하며, 예측 가능하고, 빠릅니다. 대담함은 결함입니다.
  • 콘텐츠 표면(문서, 기사): 읽기가 작업입니다. 편안한 행 길이, 명확한 제목 수준, 절제.

계층 및 레이아웃

  • 시선은 크기, 굵기, 대비, 위치(왼쪽 위, 좌횡서 언어의 경우), 그리고 고립(Isolation)에 의해 가장 강하게 이끌립니다. 요소 주변의 공간은 상자보다 우선합니다.
  • 세 가지 텍스트 수준(디스플레이, 본문, 메타)이면 보통 충분합니다.
  • 모든 것은 무언가에 정렬됩니다. 몇 픽셀의 오차는 깨진 것으로 인식됩니다.
  • 근접성 그룹. 그룹 내부는 좁게, 섹션 사이는 느슨하게.
  • 간격은 스케일에서만 가져옵니다. 일관된 수직 리듬은 "디자인된 것처럼 보인다"는 느낌의 대부분을 차지합니다.
  • 의미를 앞에 배치하세요. 사람들은 제목과 첫 단어를 훑어봅니다. 훑어보기만으로도 메시지를 전달해야 합니다.
  • 모바일 우선: 375px 칼럼에서 살아남는 것이 진정한 계층입니다. 페이지 본문은 가로로 스크롤되지 않습니다. 넓은 테이블과 코드는 자체 컨테이너 내에서 스크롤됩니다.

콘텐츠 분배

모든 것을 담고 있는 페이지는 메시지를 묻어버립니다.

  • 홈 또는 랜딩 페이지는 하나의 메시지, 하나의 기본 액션, 각 주요 영역에 대한 짧은 포인터를 전달합니다. 방향을 제시하고 라우팅하기에 충분합니다.
  • 깊이(Depth)는 전용 페이지에 있으며, 주제당 하나씩입니다.
  • 홈 페이지 섹션이 짧은 단락과 링크 이상을 필요로 한다면, 아마도 티저와 함께 자체 페이지가 있어야 합니다.
  • 모든 티저는 해당 페이지로 연결됩니다. 모든 페이지는 뒤로 및 옆으로 연결됩니다. 링크 없이 콘텐츠를 분할하는 것은 단지 감추는 것일 뿐입니다.

상태 및 마이크로카피

  • 빈(Empty), 로딩(Loading), 오류(Error), 부분(Partial) 및 성공(Success) 상태를 디자인하세요. 전체 상태만이 아닙니다.
  • 모든 액션은 눈에 보이는 피드백을 제공합니다.
  • 레이블은 사용자의 언어로 결과를 말합니다. 내부 이름(열거형 값, 필드 키, 팀 코드명)을 독자에게 절대 보여주지 마세요.
  • 액션은 플로우 전반에 걸쳐 동일한 이름을 유지합니다: "발행"은 "발행됨"을 생성합니다.

실제 문구는 copywriter에 전달하세요.

렌더 및 검증

  1. 실제 페이지를 빌드하고 엽니다. 375px와 전체 너비에서, 라이트 모드와 다크 모드가 있다면 둘 다에서 엽니다. 헤드리스 브라우저(예: Playwright)를 사용하여 전체 페이지 스크린샷을 찍습니다.
  2. 의도(Intent)와 스크린샷을 비교합니다. 그런 다음 회색조로 변환하고 계층이 여전히 유지되는지 확인합니다.
  3. 브라우저 콘솔을 읽습니다. 깨진 레이아웃은 종종 이를 설명하는 오류가 있습니다.
  4. 원인을 수정하고 다시 렌더링합니다. 2~3회 정도가 일반적입니다.
  5. 변경 사항이 적용되었음을 입증하세요. 아무것도 일치하지 않는 스타일 편집은 자동으로 아무 일도 일어나지 않습니다. 변경 사항을 토글하고 픽셀이 다른지 확인합니다.
  6. 다른 사람의 변경 사항을 검토하는 경우, 이전 버전의 저장된 스크린샷과 비교하고 변경된 내용만 보고합니다.
  7. 렌더링된 페이지에서 접근성 검사를 실행합니다. 기존 페이지의 경우, 기준선과 비교하여 새로운 문제가 기존 문제 사이에서 사라지지 않도록 합니다.

메트릭(Lighthouse 점수, 대비 검사기, 픽셀 차이)은 하나의 속성을 확인합니다. 페이지가 좋은지 알려줄 수 없습니다. 렌더링하고 보세요.

가능하면, 검토자에게 스크린샷뿐만 아니라 클릭할 수 있는 실행 중인 미리보기를 제공하세요. 상호작용, 스크롤 및 반응형 동작은 정지 이미지에 나타나지 않습니다.

비평 출력

영향이 큰 순서대로 순위를 매겨 발견 사항을 보고하세요. 각각에 대해: 무엇을 보았는지, 어디에서, 그것이 의도에 비해 왜 중요한지, 그리고 수정 방법. 그런 다음 목록만 남기지 말고, 직접 할 수 있는 수정 사항을 적용하세요. 취향("나는 ~를 선호한다")과 결함("기본 액션이 375px에서 접힌 부분 아래에 있다")을 구분하세요.

주의사항(Gotchas)

  • 구조가 문제인 페이지를 스타일만 다시 적용하는 것. 혼란스러운 페이지에 새로운 색상을 입히면 혼란스러운 페이지가 새로운 색상으로 바뀔 뿐입니다.
  • 각 페이지가 다르게 크기를 조정하는 공유 헤더 또는 푸터. 공유 부분은 자체 너비와 간격을 소유해야 합니다. 그렇지 않으면 모든 페이지가 어긋납니다.
  • 예외 목록으로 패턴을 수정하는 것. "이 다섯 선택자에서 테두리를 숨김"은 여섯 번째에서 깨집니다. 규칙을 원인을 제공하는 상태에 맞추세요.
  • 데스크톱 너비에서만 디자인하는 것. 375px 뷰는 계층 결정이 강제되는 곳입니다. 마지막에 하면 다시 해야 합니다.
  • 제품 표면에서의 대담함. 랜딩 페이지에서 즐거움을 주는 히어로 애니메이션은 대시보드에서 노이즈입니다.
  • 코드에서 완료되었다고 판단하는 것. 빌드가 당신이 상상한 것과 일치하지 않을 수 있습니다. 보세요.

검증

  • 의도 문장이 작성되었음. 낯선 사람이 렌더링을 본 후 5초 이내에 페이지의 목적을 말할 수 있음.
  • 중앙값 검사 통과: 방향이 다른 유사한 브리핑에 답할 수 없었음.
  • 뷰당 정확히 하나의 기본 액션이 있으며, 그것이 가장 눈에 띄는 요소임.
  • 계층이 회색조에서 유지됨.
  • 그리드와 스케일의 정렬 및 간격. 오차 없음.
  • 최대 세 가지 텍스트 수준과 두세 가지 서체.
  • 렌더링된 페이지에서 대비가 AA 통과 (visual-design 참조).
  • 375px 너비에서 가로 페이지 스크롤 없음.
  • 빈, 로딩 및 오류 상태가 렌더링되고 확인됨.
  • 마지막 변경 후 스크린샷을 촬영하고 변경 사항이 보이는지 확인함.

Individual skills in this repo

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

관련 스킬