Communitygithub.com

로컬 디자인 시스템 (Local Design System)

시각적 결과물(HTML/CSS 파일, 웹 아티팩트, 랜딩 페이지, 포스터, 보고서, 대시보드 등)의 디자인 방향, 토큰, 레이아웃, 접근성 규칙을 정의하여 일관된 디자인 품질을 보장합니다.

로컬 디자인 시스템 (Local Design System)란 무엇인가요?

이 스킬은 시각적 결과물을 생성할 때 디자인 일관성과 품질을 유지하기 위한 규칙과 지침을 제공합니다. 사용자가 특정 브랜드나 디자인 시스템을 지정하지 않은 경우에도 명확한 미적 방향을 선택하고, CSS 커스텀 속성 기반의 토큰 세트를 먼저 정의하여 일관된 스타일을 적용합니다. 또한, 불필요한 장식이나 가짜 콘텐츠를 금지하는 '안티-슬롭' 규칙을 통해 디자인 순도를 높이며, 접근성과 사용성을 코드 작성 단계부터 고려합니다. HTML/CSS를 직접 작성하는 환경(Claude Code, Cursor, 일반 웹 프로젝트 등)에서 사용 가능하며, 특히 랜딩 페이지, 포스터, 보고서 등 시각적 피드백이 중요한 결과물에 적합합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/altitudezhang-commits/agent-skills-pack/tree/HEAD/local-design-system

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

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

문서

페이지, 아티팩트 및 HTML/CSS 출력을 위한 디자인 규율

이 스킬은 결과물이 시각적인 경우 사용하세요: HTML/CSS 파일, 웹 아티팩트, 랜딩 페이지, 포스터, 보고서 또는 메모 페이지, 대시보드 모형, 또는 사람이 볼 모든 페이지. 오직 취향과 구조만을 규정합니다 — 결과물이 어떻게 전달되는지(아티팩트 도구, 파일, 내보내기)는 작업 자체가 결정합니다.

출처: 아래 규칙은 BaoCut에 내장된 design 및 design-system 스킬에서 각색되었으며, 이 스킬들은 다시 Anthropic의 anthropic-design 스킬에서 이식되었습니다(출처 노트는 references/brand-colors.md 참조). BaoCut-canvas 메커니즘(.dc.html, DCLogic, canvas.json, design_check, 자산 가져오기 도구)은 의도적으로 제거되었습니다. 여기서는 HTML/CSS를 직접 작성한다고 가정합니다. 복사된 참조에서 'board/artboard'는 사용자가 생성 중인 페이지 또는 파일로 읽고 <helmet>은 <head>로 읽으십시오.

레이아웃 전에 방향 결정

  • 무엇이든 발명하기 전에 디자인 맥락을 수집하세요: 사용자의 브랜드, 기존 디자인 시스템, 이 페이지가 나란히 위치할 코드베이스나 페이지, 사용자가 제공한 스크린샷이나 파일. 고충실도 디자인은 그 맥락에서 성장합니다. 처음부터 전체 제품을 모형화하는 것은 최후의 수단이며 빈약한 작업을 생성합니다.

  • 브랜드나 디자인 시스템이 지정된 경우, 색상, 서체, 간격, 반경, 글꼴을 정확히 일치시키고 이 스킬의 모든 기본값을 무시하도록 하세요. 사용자가 브랜드나 제품 이름을 지정하면, 맹목적으로 디자인하지 말고 실제 자산을 요청하거나 가져오세요.

  • 아무도 대답할 수 없고 어떤 시스템도 제약하지 않을 때는, 하나의 명명된 의도적인 미적 방향(극단적으로 미니멀, 맥시멀리스트, 레트로-퓨처, 에디토리얼, 브루탈리스트, 아르데코, 소프트 파스텔, 인더스트리얼, 럭셔리, 장난기...)을 선택하고 한 줄로 가정을 명시한 다음 구축하세요. 아무도 대답할 수 없는 질문으로 끝내지 마십시오. 매번 같은 모양으로 조용히 수렴하지 마십시오.

  • 두 가지 이상의 결정이 결과를 바꾸고 누군가가 대답할 수 있다면, 구축 전에 한 번만 물어보세요 — 최대 4개의 질문으로, 각 질문은 2-4개의 구체적이고 진정으로 다른 옵션(먼저 권장 사항 제시)을 제공하고, 상투적인 요구사항 수집은 하지 마십시오. 그렇지 않으면 결정하고, 선택한 것을 말하고, 진행하세요.

구축 전에 토큰 세트 정의

  • 레이아웃을 작성하기 전에 작은 토큰 세트를 작성하고 해당 값만 사용하세요. 파일 상단의 :root CSS 사용자 정의 속성 블록(또는 페이지가 로드하는 토큰 파일)에 배치 — 페이지가 사용하는 모든 색상, 크기 및 글꼴이 그 값을 추적하며, 값당 하나의 소스:
:root{
  --surface: #faf7f2;              /* 유일한 톤 베이스 */
  --ink: #211d19;
  --accent: oklch(0.62 0.14 45);   /* 0–2 악센트, oklch */
  --font-display: "Space Grotesk", "Avenir Next", sans-serif;
  --font-body: "Source Sans 3", system-ui, sans-serif;
  --space-1: 4px; --space-2: 8px; --space-3: 16px; --space-4: 24px; --space-5: 40px;
  --radius-sm: 6px; --radius-md: 10px;
}
  • 색상: 하나의 톤 베이스(따뜻함, 차가움 또는 중성). 흰색과 검은색은 약간의 색조를 띱니다 — 순수한 흰색의 채도는 0.02 미만으로 유지. 전체 페이지 배경으로 순수 #FFF를 절대 사용하지 마십시오. 악센트: 0-2개, oklch로 표현되며 동일한 채도와 명도, 색상만 다릅니다. 브랜드/시스템 색상을 선호합니다. 너무 제한적이면, 새로운 색상을 발명하는 대신 그 색상에서 조화로운 oklch 색상을 유도하세요.

  • 서체: 1-3개 패밀리 — 세련된 본문 서체와 짝을 이루는 독특한 디스플레이 서체. 모든 웹폰트는 메트릭 일치 시스템 폴백을 갖습니다. 폴백은 글꼴이 로드되는 동안과 임베드할 수 없는 곳에서 렌더링되기 때문입니다. 첫 번째 선택으로 일반 기본값은 피하세요: Inter, Roboto, Arial 또는 Fraunces 없음. 의도적인 효과가 필요하지 않는 한, 자간은 0으로 유지.

  • 또한 동일한 토큰 패스에서 작은 서체 스케일(디스플레이/제목/헤딩/본문/작은 글씨/캡션, 크기, 두께, 줄 높이 포함), 간격 스케일 및 반경 스케일을 고정하세요. 실제 소스의 정확한 값은 그대로 복사 — 절대 반올림하거나 4/8px 그리드에 맞추지 마십시오.

안티-슬롭 규칙(하드)

  • 장식으로 큰 그라데이션 워시나 그라데이션 배경 없음, 청자색 그라데이션 없음, 색상 왼쪽 테두리 악센트가 있는 둥근 카드 없음, 아이콘이나 UI 글리프로 이모지 사용 금지(아이콘은 인라인 스트로크 SVG 또는 실제 아이콘 세트; 이모지는 브랜드의 진정한 일부인 경우에만 나타남).

  • 채우기 콘텐츠 없음: lorem ipsum 없음, 발명된 통계, 사용후기 또는 공간을 채우기 위해 추가된 "데이터 슬롭" 없음. 모든 요소는 그 위치를 얻습니다. 비어 있는 느낌의 섹션은 콘텐츠 발명 프롬프트가 아니라 레이아웃 문제입니다. 누락된 사실은 [YOUR PRICE]와 같이 시각적으로 표시된 자리 표시자가 됩니다.

  • 가짜 크롬 없음: 장치 모형 내부에 가짜 전화 상태 표시줄이나 키보드를 절대 그리지 마십시오.

  • 실행의 야망을 방향과 일치시키세요: 맥시멀리스트 디자인은 풍부한 효과를 얻고, 미니멀 디자인은 간격과 디테일에서 절제와 정밀함을 얻습니다. 대담한 악센트가 있는 지배적인 색상은 소심하고 고르게 분포된 색상보다 낫습니다. 비대칭, 중첩, 넉넉한 흰 공간 또는 제어된 밀도가 기본 중앙 정렬 그리드보다 낫습니다.

레이아웃 메커니즘

  • 형제 그룹(버튼, 칩, 카드, 내비게이션 항목, 툴바)은 flex 또는 grid와 gap을 사용하여 배치 — 형제 간에 공백 텍스트 노드나 요소별 여백을 절대 사용하지 마십시오. 인라인 흐름은 가끔 <a>/<strong>이 포함된 산문용이며, UI 요소를 배열하는 데 사용되지 않습니다.

  • 페이지는 유동적입니다: 루트에 px 너비 없음, max-width 컨테이너와 측면 패딩, %/rem/fr 크기 조정, 그리드는 repeat(auto-fit, minmax(min(<min>px, 100%), 1fr))로 작성되어 전화기에서 한 열로 축소되고 넘치지 않습니다. vh는 진정으로 화면을 채우는 루트에만 사용. 더 많은 콘텐츠가 뒤따르는 섹션은 px/rem min-height를 사용합니다. 잘린 것보다 약간 너무 긴 것을 선호합니다.

  • 고정 크기 루트는 고정 형식(장치 모형, 포스터, 소셜 이미지, 인쇄물)에만 사용됩니다. 모바일 앱 화면은 390×844입니다. 페이지는 전화 너비에서 작동하도록 설계 — 제목이 어색하게 끊어지지 않고, 그리드가 찌그러지지 않고, 텍스트가 가독성 이하로 줄어들지 않아야 합니다.

  • 전달 페이지의 다이어그램은 일반적인 인라인 SVG입니다(<figure> 안에 있어도 괜찮음). 누군가 편집해야 할 수 있는 곳에 레이블과 콜아웃을 실제 텍스트로 유지하세요.

접근성은 나중에 확인하는 것이 아니라 처음부터 그려 넣음

  • 정적 모형에서도 실제 요소를 사용하세요: <button>, <a href>, <label>이 있는 <input>. role이나 onClick을 div/span에 대체품으로 절대 배치하지 마십시오 — 키보드가 건너뛰고 스크린 리더가 아무것도 얻지 못합니다. 아이콘 전용 버튼에는 aria-label을 사용합니다. 장식용 SVG에는 aria-hidden="true", 의미 있는 SVG에는 role="img"와 레이블을 사용합니다.

  • 텍스트 대비는 배경에 대해 최소 4.5:1입니다(24px 이상 텍스트는 3:1). 일반적인 실패는 회색 캡션 텍스트와 흰색 텍스트 아래의 색상 채우기입니다 — 통과할 때까지 둘 다 어둡게 만드세요.

  • 구별해야 하는 색상은 색상뿐만 아니라 명도도 달라야 합니다. 빨강/녹색보다 파랑/주황을 선호합니다.

  • 히트 타겟은 최소 44px입니다. 인쇄 본문 텍스트는 최소 12pt입니다.

콘텐츠 및 편집 규율

  • 자료를 추가하기 전에 물어보세요: 추가 섹션, 페이지 또는 사본이 작품을 향상시킬 경우, 요청 없이 추가하는 대신 먼저 물어보세요.

  • 작고 목표 지향적인 변경은 해당 부분만 변경합니다: 다른 모든 레이아웃 값, 간격, 글꼴, 크기, 위치, 색상 및 콘텐츠는 정확히 그대로 유지됩니다. 요청된 변경을 수행한 다음, 요청 없이 수행하는 대신 더 큰 것을 제안하세요. 재설계 또는 처음부터 다시 시작하라는 요청은 다릅니다 — 그런 다음 큰 변경을 수행하세요.

  • 기존 페이지나 문서를 확장할 때는 먼저 시각적 어휘를 읽으십시오 — 스타일, 팔레트, 어조, 호버 상태, 그림자 및 카드 패턴, 밀도를 복사하고 그 안에서 작성하세요.

  • 소스를 얻을 수 있는 인터페이스를 재현하라는 요청을 받으면 실제 소스에서 작업하세요: 구성 요소와 스타일을 읽고, 실제 자산을 복사하고, 정확한 값을 복사하세요. 소스가 존재할 때 메모리나 스크린샷에서 절대 재현하지 마십시오. 그곳에서 일하지 않는 사람을 위해 다른 회사의 독특한 독점 디자인을 재현하지 마십시오. 대신 실제 목표를 목표로 한 독창적인 디자인을 제공하세요.

랜딩 페이지 및 인쇄

  • 랜딩 페이지: 한 문장으로 무엇을 제공하는지 말하는 하나의 히어로, 하나의 명확한 행동 촉구; 방문자가 신뢰할 수 있는 증거(사용후기, 로고, 숫자 — 그들의 것이거나 시각적으로 표시된 자리 표시자); 기능을 나열하는 대신 실제 반대 의견에 답하는 혜택 섹션. 페이지당 하나의 기본 작업, 페이지가 내려갈수록 반복됩니다. 카피는 제품 자체입니다: 구체적이고, 사용자가 실제로 판매하는 것에 뿌리를 두고 있으며, 절대 상호 교환 가능한 마케팅 상투어가 아닙니다.

  • 인쇄물(포스터, 전단지, 브로셔, 메모, 보고서, PDF로 내보내는 모든 것): 시작하기 전에 references/print.md를 읽으십시오 — 먼저 고정 페이지 대 흐르는 문서를 결정하고, 실제 용지 크기(레터 816×1056, A4 794×1123 CSS px), ≥40px 안전 여백, ≥1px 규칙, #767676보다 밝은 회색 텍스트는 사용하지 말고, 전단지 위계는 방 건너편에서 3초 안에 읽을 수 있어야 합니다.

Anthropic 브랜드 작업

  • Anthropic/Claude 브랜드를 사용하는 작업의 경우: 베이스 Ivory #FAF9F5, 텍스트 Slate #141413, 악센트 Clay #D97757, 세리프 디스플레이 서체와 산세리프 본문. 전체 웜-그레이 램프, 보조 팔레트 및 로고 규칙은 references/brand-colors.md에 있습니다. 글꼴 스택과 서체 스케일은 references/brand-typography.md에 있습니다. 크림 베이스 + 세리프 헤드라인 + 테라코타 습관은 Anthropic 브랜드 작업이나 브리핑에서 요구할 때 사용 — 모든 것의 기본값이 아닙니다.

참조

  • references/craft.md — 이 규칙 뒤의 전체 추론: 사용자와 함께 방향 선택, 변형 및 와이어프레임 라운드, 랜딩 페이지 구조, 소스에서 인터페이스 재현 및 공유 콘텐츠 규칙. 디자인 결정에 이의가 제기되거나 작품에 깊이가 필요할 때 읽으십시오.

  • references/brand-colors.md — Anthropic 브랜드 색상 시스템(웜 그레이, Claude 팔레트, 데이터 시각화 스케일) 및 출처 노트.

  • references/brand-typography.md — 메트릭 일치 폴백 및 브랜드 서체 스케일이 포함된 Anthropic 브랜드 글꼴 스택.

  • references/print.md — 인쇄 공예: 고정 대 흐르는 페이지, 용지 크기 및 단위, 여백, 표, 전단지 규칙.

관련 스킬