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

Design System 스킬.

브랜드 및 디자인 시스템 작업을 위한 Claude Code 및 Codex skill: 3계층 디자인 token, 컴포넌트 사양 및 슬라이드 생성.

  • Brand & Design Systems
  • 디자인 시스템
nextlevelbuilder/ui-ux-pro-max-skill · .claude/skills/design-system/SKILL.mdSKILL.md
--- name: design-system description: Token architecture, component specifications, and slide generation. Three-layer tokens (primitive→semantic→component), CSS variables, spacing/typography scales, component specs, strategic slide creation. Use for design tokens, systematic design, brand-compliant presentations. --- ## When to Use ## Token Architecture ## Script Paths ## Quick Start ## Component Spec Pattern ## Scripts
업스트림 파일에서 읽은 전문 및 섹션 제목 2026-09-14 · 전체 7,414자

01 기능

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

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

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

스킬 자체의 표현으로

3계층 디자인 토큰 아키텍처(primitive → semantic → component), 컴포넌트 명세, 브랜드 규정을 준수하는 프레젠테이션 슬라이드를 생성합니다. Primitive 토큰은 --color-blue-600과 같은 원시 값을 정의합니다. Semantic 토큰은 용도에 따라 이를 별칭으로 매핑합니다(--color-primary). Component 토큰은 컴포넌트별 사용법을 지정합니다(--button-bg).

이 스킬은 CSS 변수, Tailwind 테마 통합을 위한 생성 및 검증 스크립트와, 15개의 덱 구조, 25개의 레이아웃, Duarte의 스파크라인 감정 곡선(sparkline emotion arc)에 걸쳐 BM25 검색을 사용하는 상황 인지형 슬라이드 시스템을 제공합니다. 모든 슬라이드는 design-tokens.css를 임포트해야 하며 CSS 변수만 사용해야 합니다. 데이터 시각화에는 Chart.js가 필요합니다. Pexels와 Unsplash 이미지 가져오기를 지원합니다.

산출물

  • 토큰을 참조해야 하는데 소스 코드에 하드코딩된 값을 식별하는 토큰 검증 보고서
예시 프롬프트 보기 ↗

작동 방식

  1. 01
    토큰 아키텍처 참조 문서 로드

    이 스킬은 토큰을 생성하거나 검증하기 전에 references/token-architecture.md를 로드하여 3계층 토큰 구조를 설정합니다.

  2. 02
    JSON 설정에서 CSS 생성

    JSON 설정 파일과 함께 generate-tokens.cjs를 실행하여 3계층 토큰 구조를 CSS 변수로 담은 CSS 파일을 출력합니다.

  3. 03
    목표별 슬라이드 전략 검색

    search-slides.py를 통한 BM25 검색을 사용하여 slide-strategies.csv에서 도메인(카피 또는 차트)과 맥락적 위치로 선택적으로 필터링하면서 일치하는 덱 구조, 감정 아크, 스파크라인 비트를 찾습니다.

  4. 04
    맥락적 의사결정 흐름 적용

    목표를 파싱하고, 레이아웃과 break_pattern 플래그를 위해 slide-layout-logic.csv를, 타입 스케일을 위해 slide-typography.csv를, 색상 처리를 위해 slide-color-logic.csv를, 이미지 카테고리를 위해 slide-backgrounds.csv를 조회합니다.

  5. 05
    디자인 토큰으로 HTML 생성

    assets/design-tokens.css를 가져오고, 모든 스타일링에 var()를 사용하며, 차트를 위해 Chart.js를 포함하고, slide-animations.css에서 내비게이션 및 애니메이션 클래스를 추가하는 슬라이드 HTML을 생성합니다.

  6. 06
    토큰 준수 검증

    slide-token-validator.py를 실행하여 생성된 슬라이드 HTML이 CSS 변수만 사용하고 하드코딩된 색상, 폰트, 여백 값을 포함하지 않는지 확인합니다.

02 적합성 확인

design-system Skill을 사용해야 하는 경우

이러한 종류의 브랜드 및 디자인 시스템 작업의 경우 Claude Code 또는 Codex에서 design-system 스킬을 사용하십시오. 아래의 적합성 및 제한 사항은 스킬 자체 파일에서 가져온 것입니다.

적합한 경우

  • 테마 전환과 컴포넌트 커스터마이징을 위한 3계층 아키텍처로 디자인 토큰 시스템 생성
  • hover, active, disabled 변형을 포함한 컴포넌트 상태 명세 정의
  • 맥락적 레이아웃 선택과 감정 아크 계획을 통한 브랜드 준수 프레젠테이션 슬라이드 생성
  • 컴포넌트 토큰을 사용하여 디자인 명세를 Tailwind 테마 설정으로 변환
  • 체계적인 여백 및 타이포그래피 스케일을 사용한 디자인-투-코드 핸드오프

한계 인지하기

  • 하드코딩된 색상, 폰트, 여백 값은 허용되지 않으며, 모든 스타일링은 design-tokens.css의 CSS 변수를 사용해야 합니다

제공할 사항

  • 브랜드 가이드라인 문서docs/brand-guidelines.md는 프리미티브 토큰 추출에 참고할 브랜드 아이덴티티, 톤, 색상 정의를 제공합니다.
  • 검증을 위한 소스 디렉터리validate-tokens.cjs가 토큰을 사용해야 하는 하드코딩된 값을 스캔할 프로젝트 디렉터리 경로입니다.

03 스킬 내부

디자인 시스템 스킬이 Claude Code와 Codex에 부여하는 규칙

SKILL.md가 에이전트에게 설정하는 8가지 구체적인 지시, 기본값, 제한 — 결과를 바꾸는 파일의 부분입니다.

  1. 컴포넌트에서 원시 헥스 값을 사용하지 않기

    컴포넌트는 항상 CSS 변수를 통해 토큰을 참조해야 하며, 색상 값을 직접 하드코딩해서는 안 됩니다.

  2. 모든 슬라이드는 design-tokens.css를 가져와야 함

    모든 슬라이드 HTML 파일은 assets/design-tokens.css를 단일 소스로 가져와야 하며, 모든 스타일링 속성에 var()를 사용해야 합니다.

  3. 데이터 시각화에 Chart.js 사용

    차트는 CSS만으로 만든 바 또는 다른 방식이 아니라 Chart.js(버전 4.4.1 이상)로 렌더링해야 합니다.

  4. 스크립트 경로는 SKILL.md 디렉터리 기준 상대 경로

    scripts/generate-tokens.cjs와 같은 스크립트 경로는 프로젝트 루트가 아니라 SKILL.md가 있는 디렉터리를 기준으로 한 상대 경로입니다.

  5. 불투명도 제어를 위해 HSL 형식 사용

    토큰 값은 토큰 정의를 중복하지 않고 불투명도 조정을 가능하게 하기 위해 HSL 색상 형식을 사용해야 합니다.

  6. 1/3 및 2/3 지점에서의 패턴 브레이크

    프리미엄 덱은 Duarte 스파크라인 방식에 따라 덱 위치의 1/3과 2/3 지점에서 계산된 패턴 브레이크와 함께 '현재 상태'(불만)와 '미래 가능성'(희망)의 감정을 번갈아 표현합니다.

  7. 슬라이드는 설득에 초점을 맞춰야 함

    생성되는 모든 슬라이드는 내비게이션(키보드 화살표, 클릭, 진행률 표시줄)을 포함해야 하며, 콘텐츠를 중앙 정렬하고 설득 또는 전환 목표에 초점을 맞춰야 합니다.

  8. 모든 토큰의 목적을 문서화

    각 토큰 정의에는 시스템 내에서의 의도된 목적을 설명하는 문서가 포함되어야 합니다.

04 활용하기

Claude Code 또는 Codex에 design-system 설치

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

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

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

Terminal
npx skills add https://github.com/nextlevelbuilder/ui-ux-pro-max-skill --skill design-system

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

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

이 프롬프트를 자신의 콘텐츠와 제약 조건으로 수정한 다음 Claude Code 또는 Codex에서 실행하십시오.

Example prompt
/slides:create "10-slide investor pitch for ClaudeKit Marketing"

출처: SKILL.md 예시(원문 그대로).

첫 번째 결과 확인

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

  • Chart.js 스크립트 태그가 존재하고 차트가 CSS 전용 렌더링이 아닌 Chart.js 생성자를 사용하는지 확인합니다
  • 컴포넌트 스펙이 default, hover, active, disabled 열을 포함한 상태 테이블 패턴을 따르는지 확인합니다
  • assets/designs/slides/claudekit-pitch-251223.html의 참조 구현을 검토하여 기능 완성도를 확인합니다

OpenDesign에서 SKILL.md 링크를 통해 design-system을 가져옵니다: Plugins → Add → Skill → Import from link를 선택한 다음 상단 바에서 선택합니다.

05 오픈 소스, 추적 가능

출처, 라이선스 및 검증

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

스킬 파일
.claude/skills/design-system/SKILL.md 검증 시 기록된 콘텐츠 체크섬; 커밋 7f69fed
License
MIT LICENSE 파일 참조; SKILL.md에 "MIT" 명시.
리포지토리 스타
127,450 nextlevelbuilder/ui-ux-pro-max-skill 리포지토리 전체에 대해 2026-09-14에 촬영한 GitHub 스냅샷이며, 이 카탈로그에는 7개의 스킬이 포함되어 있습니다. design-system의 평가나 사용 횟수가 아닙니다.
OpenDesign에서 검증됨
2026-09-14 소스 파일, 경로, 라이선스 텍스트 및 스타 수가 확인되었습니다. OpenDesign 메인에 번들로 포함되지 않음(2026-08-28 확인); 이 페이지에 실제 실행 기록이 없습니다.

SKILL.md 내부

  1. 사용 시기디자인 토큰, 컴포넌트 스펙, CSS 변수, 스페이싱 스케일, 디자인-투-코드 핸드오프, Tailwind 설정, 슬라이드 생성
  2. 토큰 아키텍처3계층 구조: 원시 값(primitive), 목적 별칭(semantic), 컴포넌트별 토큰과 CSS 변수 예시
  3. 스크립트 경로스크립트 경로는 SKILL.md 디렉터리 기준 상대 경로이며, 파일 접근을 위한 작업 디렉터리는 프로젝트 루트입니다
  4. 빠른 시작JSON 설정에서 토큰을 생성하고 소스 디렉터리에서 토큰 사용을 검증하는 명령입니다
  5. 참조 자료아키텍처, 원시/의미/컴포넌트 토큰, 스펙, 상태, 변형, Tailwind 통합을 다루는 일곱 개의 참조 파일
  6. 컴포넌트 스펙 패턴default, hover, active, disabled 상태에 걸쳐 컴포넌트 속성을 정의하는 테이블 구조
  7. 스크립트토큰 생성, 검증, BM25 슬라이드 검색, 슬라이드 토큰 검증, 이미지 가져오기의 다섯 가지 스크립트
  8. 템플릿3계층 토큰 구조를 갖춘 스타터 JSON 템플릿
  9. 통합브랜드에서 원시 값을 추출하여 컴포넌트 토큰을 Tailwind에 제공합니다. brand 및 ui-styling 스킬에 의존합니다
  10. 슬라이드 시스템디자인 토큰, Chart.js, 상황별 결정 CSV, BM25 검색을 사용하는 브랜드 준수 프레젠테이션
  11. 단일 소스브랜드 가이드라인, design-tokens.json 및 .css, slide-animations.css가 모든 슬라이드 스타일을 정의합니다
  12. 슬라이드 검색(BM25)목표별로 도메인 필터와 상황별 매개변수(위치, 총 개수, 이전 감정)를 사용해 슬라이드 템플릿을 검색합니다
스킬 자체 설명
"토큰 아키텍처, 컴포넌트 사양, 슬라이드 생성. 3계층 토큰(primitive→semantic→component), CSS 변수, 간격/타이포그래피 스케일, 컴포넌트 사양, 전략적 슬라이드 생성. 디자인 토큰, 체계적 디자인, 브랜드 규정 준수 프레젠테이션에 사용합니다."

SKILL.md의 Front-matter 설명입니다. 전체 파일은 약 7,414자입니다. GitHub에서 전체 파일 읽기.

06 설치하기 전에

design-system 스킬에 대한 질문

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

어떤 에이전트가 이 스킬을 사용해야 합니까?

이 스킬은 ui-ux-designer와 frontend-developer를 주요 에이전트로 지정합니다. brand 스킬(브랜드 색상과 타이포그래피에서 프리미티브를 추출)과 ui-styling 스킬(컴포넌트 토큰을 Tailwind config에 반영)과 통합됩니다.

Design System

실제 브랜드 및 디자인 시스템 작업 태스크에서 design-system을 실행하십시오.

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

터미널
npx skills add https://github.com/nextlevelbuilder/ui-ux-pro-max-skill --skill design-system

OpenDesign 데스크톱

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

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

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

macOS, Windows 지원