Communitygithub.com

/design-system — 디자인 시스템 관리

디자인 시스템을 감사, 문서화, 확장합니다. 컴포넌트 전체의 명명 불일치나 하드코딩된 값 확인, 컴포넌트의 변형·상태·접근성 노트 문서화, 또는 기존 시스템에 맞는 새 패턴 설계 시 사용하세요.

design-system — 디자인 시스템 관리란 무엇인가요?

이 스킬은 디자인 시스템을 체계적으로 관리할 수 있도록 돕는 도구입니다. `/design-system audit` 명령어로 전체 시스템 감사를 실행하여 명명 일관성, 토큰 커버리지, 컴포넌트 완성도를 점검하고 우선 조치 사항을 도출합니다. `/design-system document [component]` 명령어로 특정 컴포넌트의 변형, 상태, 접근성, 코드 예제를 포함한 상세 문서를 생성하며, `/design-system extend [pattern]` 명령어로 기존 시스템과 충돌하지 않는 새 컴포넌트나 패턴을 제안할 수 있습니다. Figma와 같은 디자인 도구나 위키 같은 지식 베이스가 연결되어 있으면 실시간으로 데이터를 가져와 문서를 보강할 수 있습니다. 이 스킬은 일관성, 유연성, 문서화, 버전 관리를 핵심 원칙으로 삼아 팀 전체의 디자인 일관성과 개발 효율성을 높이는 데 유용합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tmnhutwork/Landingpage-Photo-Retouch/tree/HEAD/.agents/skills/design-system-management

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

/design-system

낯선 플레이스홀더가 보이거나 연결된 도구를 확인해야 한다면 CONNECTORS.md를 참조하세요.

디자인 시스템을 관리하세요 — 일관성 감사, 컴포넌트 문서화, 새 패턴 설계.

사용법

/design-system audit                    # 전체 시스템 감사
/design-system document [component]     # 컴포넌트 문서화
/design-system extend [pattern]         # 새 컴포넌트 또는 패턴 설계

디자인 시스템의 구성 요소

디자인 토큰

시각적 언어를 정의하는 원자 값:

  • 색상 (브랜드, 의미, 중립)
  • 타이포그래피 (스케일, 굵기, 행간)
  • 간격 (스케일, 컴포넌트 패딩)
  • 테두리 (반경, 두께)
  • 그림자 (높이 레벨)
  • 모션 (지속 시간, 이징)

컴포넌트

정의된 속성을 가진 재사용 가능한 UI 요소:

  • 변형 (primary, secondary, ghost)
  • 상태 (default, hover, active, disabled, loading, error)
  • 크기 (sm, md, lg)
  • 동작 (상호작용, 애니메이션)
  • 접근성 (ARIA, 키보드)

패턴

컴포넌트를 결합한 공통 UI 솔루션:

  • 폼 (입력 그룹, 유효성 검사, 제출)
  • 내비게이션 (사이드바, 탭, 브레드크럼)
  • 데이터 표시 (테이블, 카드, 리스트)
  • 피드백 (토스트, 모달, 인라인 메시지)

원칙

  1. 창의성보다 일관성 — 시스템은 팀이 바퀴를 다시 발명하지 않도록 존재합니다.
  2. 제약 내에서의 유연성 — 컴포넌트는 조합 가능해야 하며 경직되면 안 됩니다.
  3. 모든 것을 문서화 — 문서화되지 않으면 존재하지 않는 것입니다.
  4. 버전 관리 및 마이그레이션 — 호환을 깨는 변경에는 마이그레이션 경로가 필요합니다.

출력 — 감사

## 디자인 시스템 감사

### 요약
**검토한 컴포넌트:** [X] | **발견된 문제:** [X] | **점수:** [X/100]

### 명명 일관성
| 문제 | 컴포넌트 | 권장 사항 |
|------|----------|-----------|
| [일관성 없는 명명] | [목록] | [적용할 표준] |

### 토큰 커버리지
| 카테고리 | 정의됨 | 하드코딩된 값 발견 |
|----------|--------|-------------------|
| 색상 | [X] | 하드코딩된 hex [X]개 |
| 간격 | [X] | 임의 값 [X]개 |
| 타이포그래피 | [X] | 사용자 정의 폰트/크기 [X]개 |

### 컴포넌트 완성도
| 컴포넌트 | 상태 | 변형 | 문서 | 점수 |
|----------|------|------|------|------|
| Button | ✅ | ✅ | ⚠️ | 8/10 |
| Input | ✅ | ⚠️ | ❌ | 5/10 |

### 우선 조치 사항
1. [가장 영향력 큰 개선]
2. [두 번째 우선순위]
3. [세 번째 우선순위]

출력 — 문서

## 컴포넌트: [이름]

### 설명
[이 컴포넌트가 무엇이며 언제 사용하는지]

### 변형
| 변형 | 사용 시기 |
|------|----------|
| [Primary] | [주요 액션] |
| [Secondary] | [보조 액션] |

### Props / 속성
| 속성 | 타입 | 기본값 | 설명 |
|------|------|--------|------|
| [prop] | [type] | [default] | [설명] |

### 상태
| 상태 | 시각적 표현 | 동작 |
|------|------------|------|
| Default | [설명] | — |
| Hover | [설명] | [상호작용] |
| Active | [설명] | [상호작용] |
| Disabled | [설명] | 비상호작용 |
| Loading | [설명] | [애니메이션] |

### 접근성
- **역할**: [ARIA role]
- **키보드**: [Tab, Enter, Escape 동작]
- **스크린 리더**: [다음과 같이 알림...]

### 해야 할 일과 하지 말아야 할 일
| ✅ 해야 할 일 | ❌ 하지 말아야 할 일 |
|-------------|-------------------|
| [모범 사례] | [안티 패턴] |

### 코드 예제
[프레임워크에 적합한 코드 스니펫]

출력 — 확장

## 새 컴포넌트: [이름]

### 문제
[이 컴포넌트가 해결하는 사용자 요구 또는 격차]

### 기존 패턴
| 관련 컴포넌트 | 유사성 | 부족한 이유 |
|--------------|--------|------------|
| [컴포넌트] | [공유되는 점] | [부족한 점] |

### 제안된 디자인

#### API / Props
| 속성 | 타입 | 기본값 | 설명 |
|------|------|--------|------|
| [prop] | [type] | [default] | [설명] |

#### 변형
| 변형 | 사용 시기 | 시각적 표현 |
|------|----------|------------|
| [변형] | [시나리오] | [설명] |

#### 상태
| 상태 | 동작 | 비고 |
|------|------|------|
| Default | [설명] | — |
| Hover | [설명] | [상호작용] |
| Disabled | [설명] | 비상호작용 |
| Loading | [설명] | [애니메이션] |

#### 사용된 토큰
- 색상: [어떤 토큰]
- 간격: [어떤 토큰]
- 타이포그래피: [어떤 토큰]

### 접근성
- **역할**: [ARIA role]
- **키보드**: [예상되는 상호작용]
- **스크린 리더**: [다음과 같이 알림...]

### 미해결 질문
- [디자인 검토가 필요한 결정]
- [해결해야 할 엣지 케이스]

커넥터 사용 가능 시

~~디자인 도구가 연결된 경우:

  • Figma에서 컴포넌트 직접 감사 — 명명, 변형, 토큰 사용 확인
  • 문서화를 위한 컴포넌트 속성 및 레이어 구조 가져오기

~~지식 베이스가 연결된 경우:

  • 기존 컴포넌트 문서 및 사용 가이드라인 검색
  • 업데이트된 문서를 위키에 게시

팁

  1. 감사로 시작 — 어디로 갈지 결정하기 전에 현재 위치를 파악하세요.
  2. 만들면서 문서화 — 컴포넌트를 설계하는 동안 문서화하는 것이 더 쉽습니다.
  3. 완벽보다 커버리지에 우선순위 — 10개 컴포넌트의 100%보다 컴포넌트의 80% 문서화가 더 낫습니다.

Individual skills in this repo

This repo contains 15 individual skills — each has its own dedicated page.

tmnhutwork/Landingpage-Photo-Retouch

Run a WCAG 2.1 AA accessibility audit on a design or page. Trigger with "audit accessibility", "check a11y", "is this accessible?", or when reviewing a design for color contrast, keyboard navigation, touch target size, or screen reader behavior before handoff.

tmnhutwork/Landingpage-Photo-Retouch

Get structured design feedback on usability, hierarchy, and consistency. Trigger with "review this design", "critique this mockup", "what do you think of this screen?", or when sharing a Figma link or screenshot for feedback at any stage from exploration to final polish.

tmnhutwork/Landingpage-Photo-Retouch

Generate developer handoff specs from a design. Use when a design is ready for engineering and needs a spec sheet covering layout, design tokens, component props, interaction states, responsive breakpoints, edge cases, and animation details.

tmnhutwork/Landingpage-Photo-Retouch

Audit, document, or extend your design system. Use when checking for naming inconsistencies or hardcoded values across components, writing documentation for a component's variants, states, and accessibility notes, or designing a new pattern that fits the existing system.

tmnhutwork/Landingpage-Photo-Retouch

Synthesize user research into themes, insights, and recommendations. Use when you have interview transcripts, survey results, usability test notes, support tickets, or NPS responses that need to be distilled into patterns, user segments, and prioritized next steps.

tmnhutwork/Landingpage-Photo-Retouch

Plan, conduct, and synthesize user research. Trigger with "user research plan", "interview guide", "usability test", "survey design", "research questions", or when the user needs help with any aspect of understanding their users through research.

tmnhutwork/Landingpage-Photo-Retouch

Write or review UX copy — microcopy, error messages, empty states, CTAs. Trigger with "write copy for", "what should this button say?", "review this error message", or when naming a CTA, wording a confirmation dialog, filling an empty state, or writing onboarding text.

tmnhutwork/Landingpage-Photo-Retouch

Design banners for social media, ads, website heroes, creative assets, and print. Multiple art direction options with AI-generated visuals. Actions: design, create, generate banner. Platforms: Facebook, Twitter/X, LinkedIn, YouTube, Instagram, Google Display, website hero, print. Styles: minimalist, gradient, bold typography, photo-based, illustrated, geometric, retro, glassmorphism, 3D, neon, duotone, editorial, collage. Uses ui-ux-pro-max, frontend-design, ai-artist, ai-multimodal skills.

tmnhutwork/Landingpage-Photo-Retouch

Brand voice, visual identity, messaging frameworks, asset management, brand consistency. Activate for branded content, tone of voice, marketing assets, brand compliance, style guides.

tmnhutwork/Landingpage-Photo-Retouch

Comprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG, Gemini 3.1 Pro), social photos (HTML→screenshot, multi-platform). Actions: design logo, create CIP, generate mockups, build slides, design banner, generate icon, create social photos, social media images, brand identity, design system. Platforms: Facebook, Twitter, LinkedIn, YouTube, Instagram, Pinterest, TikTok, Threads, Google Ads.

tmnhutwork/Landingpage-Photo-Retouch

Translates Figma designs into production-ready application code with 1:1 visual fidelity. Use when implementing UI code from Figma files, when user mentions "implement design", "generate code", "implement component", provides Figma URLs, or asks to build components matching Figma specs. For Figma canvas writes via `use_figma`, use `figma-use`.

tmnhutwork/Landingpage-Photo-Retouch

Use the Figma MCP server to fetch design context, screenshots, variables, and assets from Figma, and to translate Figma nodes into production code. Trigger when a task involves Figma URLs, node IDs, design-to-code implementation, or Figma MCP setup and troubleshooting.

tmnhutwork/Landingpage-Photo-Retouch

Create strategic HTML presentations with Chart.js, design tokens, responsive layouts, copywriting formulas, and contextual slide strategies.

tmnhutwork/Landingpage-Photo-Retouch

Create beautiful, accessible user interfaces with shadcn/ui components (built on Radix UI + Tailwind), Tailwind CSS utility-first styling, and canvas-based visual designs. Use when building user interfaces, implementing design systems, creating responsive layouts, adding accessible components (dialogs, dropdowns, forms, tables), customizing themes and colors, implementing dark mode, generating visual designs and posters, or establishing consistent styling patterns across applications.

tmnhutwork/Landingpage-Photo-Retouch

UI/UX design intelligence for web, mobile, and desktop. This skill should be used when designing, building, reviewing, or fixing interfaces, including pages, components, design systems, accessibility, interaction, responsive layout, typography, color, charts, and stack-specific UI implementation. Searchable local data: 79 searchable styles (50 active), 192 product palettes and reasoning profiles, 74 font pairings, 119 UX guidelines, 105 icons, 17 GSAP presets, 25 chart types, and 22 stacks.

관련 스킬