Communitygithub.com

UI 디자인

웹 또는 모바일 UI 화면이나 컴포넌트를 디자인, 구축 또는 검토하기 전에 로드하세요: 레이아웃, 간격, 타이포그래피, 색상, 그림자, 버튼, 폼, 카드, 아이콘, 내비게이션, 이미지, 카피, 모션, 접근성, 빈 상태/오류 상태. 모든 화면이 따르는 규칙이 여기에 있으며, 주제별로 하나의 참조 파일이 있습니다. 작업과 관련된 파일만 읽으세요.

UI 디자인란 무엇인가요?

이 스킬은 UI 디자인 원칙(2021년판, Michael Filipiuk 저)에서 정리된 규칙을 기반으로 하여, 웹 및 모바일 인터페이스의 일관성과 품질을 보장합니다. 레이아웃, 간격, 타이포그래피, 색상, 그림자, 버튼, 폼, 카드, 아이콘, 내비게이션, 이미지, 카피, 모션, 접근성, 빈 상태/오류 상태 등 15가지 핵심 주제를 다룹니다. 각 주제는 `references/` 폴더 아래 별도 파일로 제공되며, AI 에이전트(예: Claude Code, Cursor, Codex)는 현재 작업과 관련된 파일만 선택하여 읽을 수 있어 효율적으로 규칙을 적용할 수 있습니다. 이 스킬은 기존 저장소의 디자인 토큰이나 테마(Tailwind, CSS 변수, shadcn/MUI, components/ui/ 등)를 우선시하며, 정의되지 않은 부분만 채워 넣습니다. 사용성, 접근성, 일관성, 단순성, 외관의 우선순위로 충돌을 해결하며, WCAG 접근성 기준을 포함하여 실무에서 바로 활용 가능한 구체적인 규칙을 제공합니다. 4pt/8pt 간격 체계, 최소 16px 본문 텍스트 크기, 44x44 이상의 터치/클릭 대상, 단일 색상 사용, 색상 이외의 의미 전달 금지 등 비타협적 규칙이 포함되어 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JuanEliasJabib02/ui-design-skill/tree/HEAD

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

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

문서

UI 디자인: 인터페이스 구축을 위한 규칙

이 규칙들은 Michael Filipiuk 저 『UI Design Principles』(2021년판)에서 정리되었습니다. 이 파일은 모든 화면에 적용되는 규칙을 담고 있습니다. references/(이 파일과 같은 위치)에는 주제별로 하나씩 상세 파일이 있습니다. 작업과 관련된 파일만 읽으세요.

태그가 없는 규칙은 책에서 가져온 것입니다. **(WCAG)**는 책에 명시되지 않은 접근성 표준을 나타냅니다. **(convention)**은 격차를 메우기 위해 추가된 일반적인 업계 값을 나타냅니다. **(derived)**는 책의 고유 방법으로 계산된 값을 나타냅니다. 책의 1pt = CSS 1px = iOS 1pt = Android 1dp.

저장소의 디자인 시스템이 우선합니다.

저장소에 이미 토큰이나 테마(Tailwind 설정, CSS 변수, shadcn/MUI 테마, components/ui/ 라이브러리)가 있다면 그것을 사용하세요. 이 스킬은 정의되지 않은 부분만 채웁니다.

  • 저장소 자체의 토큰 옆에 두 번째 토큰 세트를 절대 도입하지 마세요.
  • 병렬 컴포넌트를 만드는 대신 기존 컴포넌트를 재사용하세요.
  • 저장소 자체가 아래 규칙 중 하나를 위반하는 경우(예: 실패한 대비, 32px 버튼), 저장소의 값을 유지하고 충돌을 보고하세요. 조용히 재정의하지 마세요.

규칙 충돌 시 우선순위: 사용성 > 접근성 > 일관성 > 단순성 > 외관.

빠른 경로

  1. 개성 먼저: 브랜드와 대상에 따라 유쾌함, 중립 또는 진지함 (references/personality-and-copy.md). 절대 자신의 취향으로 하지 마세요.
  2. 화면보다 토큰 먼저: 저장소 또는 references/tokens.md에서 색상, 서체 배율 및 간격 배율을 가져오세요. 그 외의 것은 사용하지 마세요.
  3. 그레이스케일 먼저: 계층, 레이아웃 및 간격을 먼저 올바르게 잡고, 그런 다음 역할이 있는 곳에만 색상을 추가하세요.
  4. 모든 상태를 가진 컴포넌트(기본, 호버, 누름, 포커스, 비활성화, 오류, 성공) 및 모든 화면 상태(빈 상태, 로딩 중, 오류, 404).
  5. 완료 보고 전: 구축한 내용에 대해 references/checklist.md를 확인하세요. 스크린샷을 찍을 수 있다면, 코드가 아닌 스크린샷을 확인하세요.

비타협적 규칙

  1. 간격은 배율에서 나옵니다. 모바일에서는 4pt 배율, 웹에서는 8pt 배율을 사용하세요. 5, 13 또는 22px 값은 사용하지 마세요.
  2. 본문 텍스트는 16–17px입니다. 어떤 텍스트도 절대 10px 미만으로 내려가지 말고, 12px 이상을 선호하세요. 작은 텍스트에 Light 체중을 사용하지 마세요.
  3. 하나의 서체, 기본값으로 산세리프체를 사용하세요. 약 5가지 크기를 사용하세요.
  4. 텍스트나 그림자에 #000000을 절대 사용하지 마세요. #1F1F1F와 같은 어두운 회색조를 사용하세요.
  5. 하나의 기본 색상, 눈에 띄어야 하는 곳에만 적용하세요. 모든 것이 눈에 띄면 아무것도 눈에 띄지 않습니다.
  6. 대비: 본문 텍스트는 4.5:1, 큰 텍스트 및 UI 부품은 3:1 (WCAG).
  7. 의미를 전달하기 위해 색상만 사용하지 마세요. 오류, 성공 메시지 및 링크에는 아이콘, 텍스트, 체중 또는 밑줄도 함께 제공하세요.
  8. 모든 탭 또는 클릭 대상은 최소 44×44입니다. 보이는 글리프가 더 작더라도 마찬가지입니다.
  9. 버튼 높이는 40–60px이며, 그룹당 하나의 기본 버튼이 있습니다. 버튼이 쌍으로 올 때 기본 버튼은 오른쪽에 있습니다. 레이블은 정확히 어떤 일이 발생하는지 말합니다.
  10. 입력 필드에는 항상 보이는 레이블이 있습니다. 플레이스홀더만으로는 레이블이 아닙니다. 인라인 유효성 검사가 있는 단일 열 양식을 사용하고, 사용자가 입력한 내용을 절대 지우지 마세요.
  11. 그림자는 부드럽고(큰 Y 오프셋, 큰 블러, 5–10% 불투명도), 대화형 또는 상승된 요소에만 사용하세요.
  12. 아이콘은 하나의 팩에서, 하나의 스타일로, 동일한 선 두께와 둥글기를 가져야 합니다. 보편적으로 알려지지 않은 아이콘에는 레이블이 있어야 합니다.
  13. 애니메이션은 피드백을 제공하고, 1000ms 미만 지속되며, 이즈 처리됩니다(절대 선형 안 됨).
  14. Lorem Ipsum을 사용하지 마세요. 실제로 짧고, 인간적인 카피를 작성하세요. 오류는 문제 해결 방법을 말합니다. 대화상자는 객체와 결과를 명명합니다.
  15. 동일한 것은 화면 전체에서 동일한 모양과 동작을 가집니다. 동작은 플랫폼 패턴을 따르세요.

읽어야 할 참조 파일

작업이 다루는 내용읽을 파일
새 프로젝트 또는 테마, 값 선택tokens.md (간격, 서체 배율, 색상 역할, 반경, 그림자, 모션, 시작 CSS)
페이지 또는 화면 레이아웃, 그리드, 간격, 계층layout.md
텍스트 스타일, 제목, 단락typography.md
팔레트, 다크 모드, 그림자, 그라데이션color-and-depth.md
버튼 및 CTAbuttons.md
폼, 입력 필드, 선택 상자, 체크박스, 유효성 검사forms.md
카드, 항목 목록cards.md
아이콘icons.md
탭 바, 상단 내비게이션, 사이드바, 링크navigation.md
사진, 일러스트레이션, 빈 상태 및 404 아트imagery.md
브랜드 느낌, 버튼 레이블, 대화상자, 오류, 어조personality-and-copy.md
전환, 호버, 로딩, 피드백motion.md
대비, 대체 텍스트, 대상, 캡션accessibility.md
재사용할 컴포넌트, 상태, 빈/404 화면, 디자인 시스템system-and-states.md
완성된 화면 검토checklist.md

모든 경로는 이 스킬의 references/ 폴더 아래에 있습니다.

관련 스킬