convez.ai
SkillDesign & UIIntermediário
kimzeze

KDH Design System — Skill de Design Coreano

kimzeze/kdh-design-system

Design System coreano com Tailwind v4 + W3C tokens + 4-mode themes

Ver no GitHub
InicialPluginScore · de 0 a 100

Sistema 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-system

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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.

License: MIT Skill


무엇이 들어있나

  • 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

Ver o original no GitHub

Bom para

Relacionados