KDH Design System — Skill de Design Coreano
kimzeze/kdh-design-system
Design System coreano com Tailwind v4 + W3C tokens + 4-mode themes
Ver no GitHubSistema de design moderno coreano pronto para usar em Claude Code, com 25 componentes, 8 padrões e 12 componentes específicos para agentes de IA. Inclui tokens Tailwind v4, 4 modos de tema (light/dark × default/agent) e conformidade WCAG AA.
Instalação
npx convez-ai kimzeze/kdh-design-system1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Criar interfaces de usuário consistentes em projetos web com padrão coreano
- Gerar componentes React/HTML automaticamente com estilos do sistema
- Padronizar design de formulários, cards, modais e padrões comuns
- Implementar temas light/dark e modos default/agent para aplicações IA
Veredito

Sistema robusto e bem documentado que automatiza a aplicação de design tokens coreano moderno em Claude Code, com forte suporte a temas e acessibilidade. Útil para equipes que querem consistência visual e geração rápida de componentes, mas exige familiaridade com Tailwind e design systems.
README
A tradução para o português deste README ainda está na fila.
KDH Design System
모던 한국어 웹 UX 디자인 시스템 — Claude Code Skill 형태로 패키징. Pretendard 본문 · 빨강 accent · 4-mode 테마(light/dark × default/agent) · W3C 3-layer Design Tokens.
무엇이 들어있나
- 25개 Components — Button, Card, Bottom Sheet, Popup, Text Field 등 (Anatomy + State Matrix + Recipe 포함)
- 8개 Patterns — 입력 폼, 약관 동의, 빈 화면, 검색 등
- 12개 AI Agent components — Prompt Text Field, Process Indicator, Context Panel 등
- 7개 UX Writing 가이드 — 완료, 재확인, 빈 화면, 거절, 오류 메시지 작성법
- Tailwind v4 토큰 — Primitive · Semantic · Component 3-layer
- 4-Mode 컬러 — light/default · light/agent · dark/default · dark/agent
- WCAG AA 준수 — Contrast 4.5:1, 44×44px touch target
설치 방법
Option 1: 개인 Skill로 설치 (가장 간단)
# Skill 폴더만 복사
git clone https://github.com/kimzeze/kdh-design-system.git /tmp/kdh-ds
mkdir -p ~/.claude/skills
mv /tmp/kdh-ds/skills/kdh-design-system ~/.claude/skills/
rm -rf /tmp/kdh-ds
Claude Code에서 자동 인식 (재시작 불필요).
Option 2: 프로젝트별 Skill (특정 프로젝트만)
cd /your-project
mkdir -p .claude/skills
git clone --depth 1 https://github.com/kimzeze/kdh-design-system.git /tmp/kdh-ds
cp -r /tmp/kdh-ds/skills/kdh-design-system .claude/skills/
rm -rf /tmp/kdh-ds
.claude/skills/를 git에 커밋하면 팀원들도 동일한 디자인 시스템 자동 적용.
Option 3: Plugin Marketplace (Claude Code 안에서)
/plugin marketplace add kimzeze/kdh-design-system
/plugin install kdh-design-system
Option 4: CSS만 복사해서 사용 (Skill 없이)
Tailwind 프로젝트에 토큰만 적용하고 싶다면:
curl -fsSL https://raw.githubusercontent.com/kimzeze/kdh-design-system/main/skills/kdh-design-system/assets/tailwind.css \
-o src/styles/kdh-design-system.css
/* src/styles/globals.css */
@import "./kdh-design-system.css";
사용 예시
설치 후 Claude Code에 다음과 같이 요청:
> 계정 생성 폼 만들어줘
→ 자동으로 KDH Design System 토큰을 사용한 React 컴포넌트 생성.
> /kdh-design-system
> 이 Button 컴포넌트를 KDH 디자인 시스템 스타일로 마이그레이션
→ 기존 코드를 KDH 토큰으로 변환.
폴더 구조
kdh-design-system/
├── README.md ← 본 파일
├── LICENSE ← MIT
├── .claude-plugin/
│ └── marketplace.json ← Plugin Marketplace 메타
└── skills/
└── kdh-design-system/
├── SKILL.md ← Skill 진입점
├── references/
│ └── DESIGN.md ← 풀 명세 (1,500줄)
└── assets/
└── tailwind.css ← Tailwind v4 토큰 (1,000줄)
핵심 토큰 (Quickstart)
/* 색상 */
--color-red-500: #e0282f; /* Brand primary — 한 화면 1번만 */
--color-gray-900: #191a1b; /* Body text */
--color-gray-50: #f3f4f6; /* Surface 02 (light) */
/* 타이포 */
--font-pretendard: "Pretendard", sans-serif; /* 본문 */
--font-display: var(--font-display-stack, system-ui), sans-serif; /* 제목 */
--text-body-medium: 15px; /* 기본 본문 */
--leading-default: 1.48; /* 기본 line-height */
/* 스페이싱 (4pt grid) */
--spacing-4: 4px; --spacing-8: 8px; --spacing-16: 16px; --spacing-24: 24px;
/* 토큰 사용 */
.btn { background: var(--fill-accent-primary); color: var(--text-inverse); }
또는 Tailwind 유틸리티:
<button className="bg-accent text-inverse rounded-8 h-48 px-24 font-semibold
hover:bg-accent-hover active:bg-accent-pressed">
계속하기
</button>
테마 전환
<html data-theme="light" data-mode="default"> <!-- 기본 -->
<html data-theme="dark"> <!-- 다크 -->
<html data-mode="agent"> <!-- AI Agent UI -->
<html data-theme="dark" data-mode="agent"> <!-- 다크 Agent -->
라이선스
MIT License — 자유롭게 복사·수정·배포 가능.
Credits
- Pretendard font — Hyun-Bin Choi
- Inspired by W3C Design Tokens Community Group standard
- Built for Claude Code Skills