사용 가이드로 건너뛰기
ui-design-system작성자 Alireza Rezvani

UI Design System 스킬.

브랜드 및 디자인 시스템 작업을 위한 Claude Code와 Codex 스킬: 디자인 토큰, 컴포넌트 문서화, 반응형 계산, 개발자 인수인계를 지원합니다.

  • Brand & Design Systems
  • 디자인 시스템
alirezarezvani/claude-skills · product-team/skills/ui-design-system/SKILL.mdSKILL.md
--- name: ui-design-system description: UI design system toolkit for Senior UI Designer including design token generation, component documentation, responsive design calculations, and developer handoff tools. Use when creating design systems, generating design tokens, maintaining visual consistency, or facilitating design-dev collaboration and developer handoff. --- ## Trigger Terms ## Workflows ## Quick Reference Tables ## Knowledge Base ## Validation Checklist
2026-09-14에 업스트림 파일에서 읽은 전문 및 섹션 제목 · 전체 10,759자

01 기능

Claude Code와 Codex에서 ui-design-system Skill이 하는 일

요약, 워크플로, 산출물을 모두 해당 스킬의 SKILL.md에서 그대로 읽어 정리한 내용입니다.

SKILL.md에서2026-09-14 읽음 · 실행 기록 아님

스킬 자체의 표현으로

하나의 브랜드 색상을 완전한 token 세트로 변환하는 디자인 시스템 툴킷. design_token_generator.py는 hex 색상과 modern, classic, playful 중 하나의 프리셋을 입력받아 색상, 타이포그래피, 8pt 간격, 크기, 테두리, 그림자, 애니메이션, 브레이크포인트, z-index 레이어를 json, css, scss 또는 요약 형태로 반환합니다.

이어지는 4개의 워크플로는 atom부터 template까지의 컴포넌트 아키텍처, clamp() 유동 타입을 활용한 반응형 브레이크포인트, WCAG 대비 검증, 그리고 React CSS 변수, Tailwind 설정, styled-components로의 개발자 핸드오프와 Tokens Studio를 통한 Figma 동기화를 다룹니다. 빌드 팀을 위해 token과 컴포넌트를 문서화해야 하는 시니어 UI 디자이너를 대상으로 합니다.

산출물

  • props, variant 옵션, 상태, 접근성 요구사항을 다루는 컴포넌트 API 문서.
  • CSS 변수를 활용한 React, Tailwind 테마 설정, styled-components에 대한 연동 코드 스니펫.
  • 자체 대비 색상을 함께 가지는 시맨틱 색상 token.
예시 프롬프트 보기 ↗

작동 방식

  1. 01
    브랜드 색상 지정하기

    이 워크플로는 브랜드 primary 색상을 식별하는 것으로 시작하며, 생성되는 모든 카테고리가 이 색상에서 파생되므로 파일은 이를 hex 형식으로 요구합니다.

  2. 02
    Token Generator 실행하기

    스크립트를 한 번 호출하면 전체 시스템이 생성되며, 색상, 스타일 프리셋, 출력 형식이 이 스크립트가 받는 세 가지 인자입니다.

  3. 03
    토큰을 컴포넌트 계층 구조에 매핑하기

    컴포넌트는 atoms, molecules, organisms, templates로 구성되며, 각 컴포넌트는 사용하는 토큰 그룹과 연결됩니다.

  4. 04
    브레이크포인트와 유동 타이포그래피 설정하기

    여섯 개의 브레이크포인트가 xs부터 2xl까지 이어지며, 유동 타이포그래피는 최소 크기와 최대 크기 사이의 clamp 공식으로 표현됩니다.

  5. 05
    토큰을 코드베이스에 연결하기

    핸드오프 워크플로에서는 토큰 파일을 직접 불러오는 방식, JSON으로부터 구성한 Tailwind 테마, 토큰 키를 읽는 styled-components 테마를 보여줍니다.

  6. 06
    Figma와 동기화하고 승인 완료하기

    토큰은 Tokens Studio 플러그인을 통해 Figma로 들어가며, 핸드오프 체크리스트는 파이프라인, 컴포넌트 라이브러리, 문서화가 모두 완료되었는지 확인합니다.

02 적합성 확인

ui-design-system 스킬을 사용해야 하는 경우

이러한 종류의 브랜드 및 디자인 시스템 작업일 때 Claude Code 또는 Codex에서 ui-design-system 스킬을 사용합니다. 적합성과 제한 사항은 스킬 자체 파일에서 가져옵니다.

적합한 경우

  • 브랜드 색상이 하나 있고, 이를 기반으로 완전한 토큰 시스템을 도출해야 하는 경우입니다.
  • 컴포넌트 라이브러리를 구조화하는 중이며, 토큰을 atoms, molecules, organisms, templates에 매핑하고자 하는 경우입니다.
  • 브레이크포인트, 유동 타이포그래피 스케일 또는 반응형 여백 값을 대신 계산해 주기를 원하는 경우입니다.
  • 완성된 토큰 세트를 개발팀에 전달할 준비를 하는 경우입니다.

한계 인지하기

  • 스타일 프리셋은 깊은 리스킨이 아닙니다. 테마 선택은 주로 폰트 스택, 기본 radius, 섀도 특성을 바꾸는 정도이며, 예를 들어 modern에서는 모서리가 8px 라운드인 반면 classic에서는 4px입니다.

제공할 사항

  • 스타일 프리셋modern, classic, playful 세 방향 중 하나를 선택합니다. 프리셋에 따라 생성된 세트 전반의 폰트 패밀리, 모서리 radius, 섀도 처리 방식이 달라집니다.
  • 출력 형식전달받는 프로젝트가 어떤 형식을 사용하는지 명시합니다. json, css, scss 또는 요약 뷰 중 하나이며, 이는 핸드오프 결과물을 결정합니다.

03 스킬 내부

ui-design-system 스킬이 Claude Code와 Codex에 부여하는 규칙

SKILL.md가 에이전트를 위해 설정하는 7가지 구체적 지침, 기본값, 한도 — 결과를 바꾸는 파일의 부분

  1. 기본 브랜드 색상

    색상이 전달되지 않으면 생성기는 기본 브랜드 색상으로 #0066CC를 사용하므로, hex 인자가 없어도 출력이 렌더링됩니다.

  2. 여백은 8pt 그리드를 따릅니다

    여백 토큰은 0에서 64까지 이어지는 8pt 그리드 기반 스케일을 따르며, 숫자 단계 위에 시맨틱 별칭이 겹쳐져 있습니다.

  3. 하드코딩된 값은 없습니다

    컴포넌트 구현은 디자인 토큰만 참조해야 하며, 컴포넌트 내 리터럴 픽셀 값이나 hex 값은 검사 실패로 처리됩니다.

  4. 모든 variant가 제공됩니다

    컴포넌트는 일부 변형만이 아니라 primary, secondary, ghost를 포함한 전체 변형 세트를 구현해야 합니다.

  5. 크기 변형은 고정된 치수를 가집니다

    small 크기는 높이 32px, 좌우 패딩 12px, 폰트 크기 14px로 정의되며, md와 lg는 여기서부터 확장됩니다.

  6. 명암 대비는 WCAG AA를 충족해야 합니다

    생성된 색상은 일반 텍스트 4.5:1, 큰 텍스트 3:1 기준으로 검증되며, 시맨틱 색상은 명암 대비 값을 정의해야 합니다.

  7. 터치 타깃은 충분히 크게 유지됩니다

    접근성 체크리스트에서 인터랙티브 요소는 최소 44x44픽셀의 터치 타깃을 확보해야 합니다.

04 활용하기

Claude Code 또는 Codex에 ui-design-system 설치

npx skills add 명령 한 번 실행 후, 에이전트에서 첫 번째 작업을 수행하고 결과 체크리스트를 확인합니다.

Claude Code, Codex 또는 사용자의 에이전트에 ui-design-system 추가

프로젝트에서 실행합니다. 설치 프로그램이 어떤 에이전트에 추가할지 묻습니다.

Terminal
npx skills add https://github.com/alirezarezvani/claude-skills --skill ui-design-system

product-team/skills/ui-design-system/SKILL.md에 대한 일반적인 skills CLI 형식이며, 저장소는 자체 경로를 문서화할 수 있습니다.

스킬에 첫 브랜드 및 design-system 작업 과제를 제공합니다

스킬 자체의 용어로 작성되었습니다. 대괄호 부분은 각자의 자료로 교체합니다.

Starter prompt
We have settled on [#0066CC] as the brand primary and I need a complete token set for our SCSS codebase, exported as variables we can import. Please generate the tokens in the classic style, document the Button, Input and Card component APIs with their variants and states, and check that the semantic colors clear WCAG AA before we hand off to the developers.

출처: 스킬 자체의 용어로 SKILL.md에서 작성했습니다.

첫 번째 결과 확인

SKILL.md 자체가 올바른 결과의 모습으로 제시하는 내용:

  • 모든 토큰 카테고리가 부분적으로만이 아니라 전부 생성되었는지 확인합니다.
  • 각 컴포넌트에서 hover, active, focus, disabled 상태가 실제로 작동하는지 확인합니다.
  • 포커스 표시가 보이는지, 시맨틱 HTML 요소가 사용되는지 확인합니다.
  • 핸드오프가 완료되었다고 하기 전에 디자인 도구가 동기화되었는지 확인합니다.
  • 내보낸 토큰이 코드에 반영되도록 빌드 파이프라인이 구성되어 있는지 확인합니다.

OpenDesign에서 ui-design-system을 SKILL.md 링크로 가져옵니다: Plugins → Add → Skill → Import from link, 그런 다음 상단 바에서 선택합니다.

05 오픈 소스, 추적 가능

출처, 라이선스 및 검증

이 페이지의 사실이 어디에서 왔으며 언제 마지막으로 확인되었는지 안내합니다.

스킬 파일
product-team/skills/ui-design-system/SKILL.md 검증 시 콘텐츠 체크섬이 기록되었습니다. 커밋 19392f7
License
MIT LICENSE에서.
리포지토리 스타
25,934 이 카탈로그에 5개의 스킬을 포함하는 전체 alirezarezvani/claude-skills 저장소에 대해 2026-09-14에 촬영된 GitHub 스냅샷입니다. ui-design-system에 대한 평가나 사용 횟수가 아닙니다.
OpenDesign에서 검증됨
2026-09-14 소스 파일, 경로, 라이선스 텍스트 및 스타 수가 확인되었습니다. OpenDesign 메인에 번들로 포함되지 않음(2026-08-28 확인); 이 페이지에 실제 실행 기록이 없습니다.

SKILL.md 내부

  1. 트리거 용어generate design tokens와 같이 요청을 이 skill로 라우팅해야 하는 인용된 문구입니다.
  2. 워크플로토큰 생성, 컴포넌트 시스템, 반응형 디자인, 개발자 핸드오프의 네 가지 번호가 매겨진 워크플로입니다.
  3. 도구 참조design_token_generator.py의 인자, 기본값, 출력 카테고리와 예시 호출입니다.
  4. 빠른 참조 표색상 스케일 단계, 1.25 타이포그래피 스케일, WCAG 레벨, 스타일 프리셋 차이입니다.
  5. 지식 베이스token-generation, component-architecture, responsive-calculations, developer-handoff의 네 가지 참조 가이드입니다.
  6. 검증 체크리스트토큰 생성, 컴포넌트 시스템, 접근성, 개발자 핸드오프에 대한 체크 목록입니다.
스킬 자체 설명
"디자인 토큰 생성, 컴포넌트 문서화, 반응형 디자인 계산 및 개발자 핸드오프 도구를 포함한 선임 UI 디자이너를 위한 UI 디자인 시스템 툴킷입니다. 디자인 시스템 생성, 디자인 토큰 생성, 시각적 일관성 유지 또는 디자인-개발 협업 및 개발자 핸드오프를 용이하게 할 때 사용합니다."

SKILL.md의 프론트 매터 설명입니다. 전체 파일은 약 10,759자입니다. GitHub에서 전체 파일 읽기.

06 설치하기 전에

ui-design-system Skill에 대한 질문

이 답변은 2026-09-14 기준으로 확인한 SKILL.md 내용을 근거로 하며, 실행 기록을 바탕으로 한 것이 아닙니다.

생성기를 실행하려면 무엇이 필요합니까?

헥스 브랜드 색상과 스타일 선택을 출력 형식과 함께 커맨드 라인에 그대로 전달합니다. 파일에 CSS 출력을 사용하는 클래식 팔레트와 같은 호출 예시가 나와 있으므로, 사전에 다른 설정이 필요하지 않습니다.

어떤 출력 형식을 얻을 수 있습니까?

JSON이 기본값이며, 동일한 스크립트가 CSS custom properties, SCSS 변수 또는 요약 뷰를 작성합니다. 예제에서는 SCSS 출력을 partial로 리다이렉트하여 바로 import할 수 있도록 합니다.

Figma 동기화는 어떻게 작동합니까?

Tokens Studio 플러그인을 설치하고 생성된 JSON을 import하면, 이후 토큰이 Figma 스타일과 자동으로 동기화됩니다. 동일한 핸드오프 워크플로가 React, Tailwind, styled-components 통합도 함께 다룹니다.

어떤 명암 대비 수준을 기준으로 작동합니까?

참조 테이블은 AA와 AAA를 모두 정의합니다. AAA는 일반 텍스트에 7:1, 큰 텍스트에 4.5:1이 필요하며, AA는 그보다 완화된 4.5:1 및 3:1 목표입니다. 큰 텍스트란 최소 18pt 레귤러 또는 14pt 볼드를 의미합니다.

UI Design System

실제 브랜드 및 design-system 작업 과제에서 ui-design-system을 실행합니다.

OpenDesign를 다운로드하고, SKILL.md 링크에서 ui-design-system을 가져온 다음, 위 프롬프트를 붙여넣고 결과를 보기 전에 계획을 읽으십시오.

터미널
npx skills add https://github.com/alirezarezvani/claude-skills --skill ui-design-system

OpenDesign 데스크톱

하나의 디자인 시스템으로 모든 결과물에 브랜드 일관성을

완전한 Vibe Design Workspace에서 하나의 브랜드 규칙을 웹사이트, 슬라이드, 인터랙티브 프로토타입, 대시보드, 이미지, HTML 영상에 적용하세요. 로컬 Codex, Claude Code, Cursor 등을 연결해 무료로 제작할 수 있습니다.

  • 웹, 슬라이드, 프로토타입, 대시보드, 이미지, 영상
  • 140개+ 디자인 시스템과 전체 템플릿·스킬 라이브러리
  • 로컬 Codex 및 21개+ 코딩 에이전트 연결 · 무료
무료 다운로드

macOS, Windows 지원