사용 가이드로 건너뛰기
visual-design-foundations작성자 Seth Hobson

Visual Design Foundations 스킬.

브랜드 및 디자인 시스템 작업을 위한 Claude Code 및 Codex 스킬입니다: 일관된 비주얼을 위한 타이포그래피, 색상 이론, 간격 시스템, 아이콘 그래피.

  • Brand & Design Systems
wshobson/agents · plugins/ui-design/skills/visual-design-foundations/SKILL.mdSKILL.md
--- name: visual-design-foundations description: Apply typography, color theory, spacing systems, and iconography principles to create cohesive visual designs. Use when establishing design tokens, building style guides, or improving visual hierarchy and consistency. --- ## When to Use This Skill ## Core Systems ## Quick Start: Design Tokens in Tailwind ## Typography Best Practices ## Color Theory ## Spacing Guidelines
2026-09-14에 업스트림 파일에서 읽은 전문 및 섹션 제목 · 전체 7,218자

01 기능

Claude Code와 Codex에서 visual-design-foundations 스킬이 수행하는 작업

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

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

스킬 자체의 표현으로

이 스킬은 타이포그래피 스케일, 색상 이론, 스페이싱 시스템, 아이콘그래피 기본 원칙을 활용하여 일관되고 접근 가능한 비주얼 시스템을 구축하는 방법을 알려줍니다. 모듈형 타입 스케일, 8포인트 그리드 스페이싱, WCAG 대비 요구 사항을 반영한 시맨틱 색상 팔레트, 아이콘 크기 체계를 이용한 디자인 토큰 수립을 다룹니다.

이 스킬은 Tailwind CSS, 반응형 유동 타이포그래피, 시맨틱 토큰 기반 다크 모드 테마, 접근성 검증을 위한 구체적인 구현 패턴을 제공합니다. 비율 기반 스케일과 재사용 가능한 토큰 시스템을 정의함으로써 일관되지 않은 스페이싱, 낮은 대비, 임의의 매직 넘버 같은 흔한 비주얼 디자인 문제를 해결합니다.

산출물

  • CSS 커스텀 프로퍼티 또는 Tailwind 설정에 정의된 디자인 토큰
  • 크기 변형이 있는 아이콘 컴포넌트
예시 프롬프트 보기 ↗

작동 방식

  1. 01
    모듈형 디자인 토큰 수립

    비율 기반 크기 조정(0.75rem~3rem)을 적용한 타이포그래피 스케일, 8포인트 그리드 스페이싱(4px~64px), 브랜드·상태·중립색을 위한 시맨틱 색상 토큰을 정의합니다.

  2. 02
    반응형 타이포그래피 적용

    뷰포트에 반응하는 크기 조정을 위해 clamp()를 사용한 유동 타이포그래피를 적용하고, 가독성을 위해 최대 65자의 최적 읽기 너비를 유지합니다.

  3. 03
    접근 가능한 색상 팔레트 구현

    WCAG 대비 비율을 충족하는 컬러 시스템을 구축합니다: 본문 텍스트는 4.5:1, 큰 텍스트와 UI 구성 요소는 3:1을 기준으로 하며, 프로그래밍 방식으로 대비를 검사합니다.

  4. 04
    일관된 아이콘 시스템 만들기

    12px에서 32px까지의 아이콘 크기 스케일을 정의하고, size prop을 받아들이며 flex-shrink-0 동작을 유지하는 재사용 가능한 컴포넌트를 만듭니다.

  5. 05
    시맨틱 토큰으로 다크 모드 디자인하기

    외형이 아닌 용도에 따라 시맨틱 토큰 이름을 사용하여, 컴포넌트 변경 없이 data attribute를 통한 테마 전환이 가능하도록 합니다.

  6. 06
    수직 리듬 유지하기

    정의된 스케일 값을 사용하여 인접 요소에 일관된 간격 규칙을 적용해 인터페이스 전반에 시각적 조화를 만듭니다.

02 적합성 확인

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

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

적합한 경우

  • 새 프로젝트를 위한 디자인 토큰 설정
  • 간격 및 크기 시스템 생성 또는 개선
  • 접근 가능한 색상 팔레트 구축
  • 아이콘 시스템 및 시각 자산 디자인
  • 시각적 일관성을 위한 디자인 감사

    제공할 사항

    • 테마 명세시맨틱 토큰 전략을 활용한 다크 모드 또는 멀티 테마 시스템 구현 요건

    03 스킬 내부

    visual-design-foundations 스킬이 Claude Code와 Codex에 제공하는 규칙

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

    1. 8포인트 그리드 간격 사용하기

      모든 간격 값은 0.25rem(4px)부터 4rem(64px)까지 4px의 배수를 따라야 하며, 정의된 간격 스케일 토큰을 사용해야 합니다.

    2. 엄격한 줄 높이 범위 적용하기

      제목은 1.1~1.3, 본문 텍스트는 1.5~1.7, UI 레이블은 1.2~1.4의 줄 높이를 사용해야 적절한 가독성을 확보할 수 있습니다.

    3. 텍스트 너비를 65자로 제한하기

      본문 텍스트의 max-width를 65ch로 설정하여 최적의 읽기 너비를 유지하고 넓은 화면에서의 눈의 피로를 방지합니다.

    4. 컴포넌트 간격 범위 적용하기

      카드 패딩은 16~24px, 섹션 간 간격은 32~64px, 폼 필드 간격은 16~24px, 아이콘-텍스트 간격은 8px로 하여 간격 스케일을 사용해야 합니다.

    04 활용하기

    Claude Code 또는 Codex에 visual-design-foundations 설치

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

    Claude Code, Codex 또는 사용자의 Agent에 visual-design-foundations 추가

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

    Terminal
    npx skills add https://github.com/wshobson/agents --skill visual-design-foundations

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

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

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

    Starter prompt
    Create a design token system for [project name] with an 8-point spacing grid, modular typography scale from 12px to 48px, and an accessible color palette including primary brand color [hex value], semantic status colors for success/warning/error, and a complete neutral gray scale. Implement both light and dark mode variants using semantic token naming. Include Tailwind configuration and verification that all text combinations meet WCAG AA contrast requirements.

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

    첫 번째 결과 확인

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

    • 프로그래밍 방식 검사를 통해 모든 텍스트 및 UI 구성 요소 색상 조합이 WCAG 대비 비율 요건을 충족하는지 확인합니다
    • 폰트 로딩이 레이아웃 이동을 방지하기 위해 font-display swap을 사용하는지 테스트합니다
    • clamp 함수를 사용하여 반응형 타이포그래피가 뷰포트 크기에 따라 부드럽게 조정되는지 확인합니다

    OpenDesign에서는 SKILL.md 링크를 통해 visual-design-foundations를 가져옵니다: Plugins → Add → Skill → Import from link, 그런 다음 상단 바에서 선택합니다.

    05 오픈 소스, 추적 가능

    출처, 라이선스 및 검증

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

    Repository
    github.com/wshobson/agents Branch main
    스킬 파일
    plugins/ui-design/skills/visual-design-foundations/SKILL.md 검증 시 기록된 콘텐츠 체크섬; 커밋 4236bb9
    License
    MIT LICENSE에서.
    리포지토리 스타
    39,635 이 카탈로그에 18개 스킬이 포함된 wshobson/agents 저장소 전체에 대해 2026-09-14에 수집된 GitHub 스냅샷입니다. visual-design-foundations의 평가나 사용 횟수가 아닙니다.
    OpenDesign에서 검증됨
    2026-09-14 소스 파일, 경로, 라이선스 텍스트 및 스타 수가 확인되었습니다. OpenDesign 메인에 번들로 포함되지 않음(2026-08-28 확인); 이 페이지에 실제 실행 기록이 없습니다.

    SKILL.md 내부

    1. 이 스킬을 사용해야 할 때토큰 정립, 팔레트 구축, 일관성 감사, 다크 모드 구현 등의 시나리오를 나열합니다
    2. 핵심 시스템모듈형 타이포그래피 스케일, 8포인트 여백 그리드, CSS 커스텀 프로퍼티를 활용한 시맨틱 컬러 토큰 구조를 정의합니다
    3. 빠른 시작: Tailwind의 디자인 토큰커스텀 폰트, 크기, 색상, 여백 값으로 테마를 확장하는 Tailwind config 예시를 제공합니다
    4. 타이포그래피 모범 사례폰트 페어링 조합, clamp를 활용한 반응형 유동 타이포그래피, 폰트 로딩 시 레이아웃 시프트 방지 방법을 다룹니다
    5. 색상 이론WCAG 대비 요구사항, 다크 모드 구현 전략, 프로그래밍 방식의 대비 비율 검사 함수를 상세히 설명합니다
    6. 여백 가이드라인컴포넌트 여백 범위를 지정하고 본문 콘텐츠의 수직 리듬 패턴을 보여줍니다
    7. 아이콘그래피12px부터 32px까지의 아이콘 크기 체계를 정의하고 TypeScript 아이콘 컴포넌트 구현을 제공합니다
    8. 모범 사례제약 조건 설정, 결정 사항 문서화, 접근성 테스트, 시맨틱 네이밍 사용을 포함한 일곱 가지 원칙
    9. 일반적인 문제일관성 없는 여백, 낮은 대비, 폰트 과부하, 매직 넘버, 다크 모드 계획 누락 등의 문제를 나열합니다
    스킬 자체 설명
    "타이포그래피, 색채 이론, 간격 시스템, 아이코노그래피 원칙을 적용하여 일관성 있는 시각 디자인을 생성합니다. 디자인 토큰 설정, 스타일 가이드 구축, 시각적 위계와 일관성 개선 시 사용하십시오."

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

    Visual Design Foundations

    실제 브랜드 및 디자인 시스템 작업에서 visual-design-foundations 실행

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

    터미널
    npx skills add https://github.com/wshobson/agents --skill visual-design-foundations

    OpenDesign 데스크톱

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

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

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

    macOS, Windows 지원