Communitygithub.com

/design-system

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

design-system란 무엇인가요?

이 스킬은 개발자와 디자이너가 디자인 시스템을 체계적으로 관리할 수 있도록 도와줍니다. `/design-system audit` 명령어로 전체 시스템 감사를 실행하여 명명 일관성, 토큰 적용 범위, 컴포넌트 완성도를 점검하고 우선 조치 사항을 도출할 수 있습니다. `/design-system document [component]` 명령어로 개별 컴포넌트의 변형, 상태, 접근성, props 등을 상세히 문서화하고, `/design-system extend [pattern]` 명령어로 기존 시스템과 일관된 새로운 컴포넌트나 패턴을 설계할 수 있습니다. Figma와 같은 디자인 도구나 지식 베이스와 연동하면 감사 및 문서화 작업을 더욱 자동화하고 효율적으로 수행할 수 있습니다. 일관성, 유연성, 문서화, 버전 관리를 핵심 원칙으로 삼아 팀 전체의 생산성과 UI 품질을 향상시킵니다.

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

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

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

문서

design-system은(는) 무엇을 하나요?

익숙하지 않은 플레이스홀더가 보이거나 연결된 도구를 확인해야 하는 경우 CONNECTORS.md를 참조하세요.

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

사용법

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

디자인 시스템의 구성 요소

디자인 토큰

시각적 언어를 정의하는 기본 값:

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

컴포넌트

재사용 가능한 UI 요소로 다음이 정의됨:

  • 변형 (기본, 보조, 고스트)
  • 상태 (기본, 호버, 활성, 비활성, 로딩, 오류)
  • 크기 (sm, md, lg)
  • 동작 (상호작용, 애니메이션)
  • 접근성 (ARIA, 키보드)

패턴

컴포넌트를 결합한 일반적인 UI 솔루션:

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

원칙

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

출력 — 감사

## 디자인 시스템 감사

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

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

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

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

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

출력 — 문서

## 컴포넌트: [이름]

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

### 변형
| 변형 | 사용 시기 |
|---------|----------|
| [기본] | [주요 작업] |
| [보조] | [지원 작업] |

### 속성
| 속성 | 유형 | 기본값 | 설명 |
|----------|------|---------|-------------|
| [속성] | [유형] | [기본값] | [설명] |

### 상태
| 상태 | 시각 | 동작 |
|-------|--------|----------|
| 기본 | [설명] | — |
| 호버 | [설명] | [상호작용] |
| 활성 | [설명] | [상호작용] |
| 비활성 | [설명] | 상호작용 불가 |
| 로딩 | [설명] | [애니메이션] |

### 접근성
- **역할**: [ARIA 역할]
- **키보드**: [Tab, Enter, Escape 동작]
- **스크린 리더**: [...

### 권장 사항 및 금지 사항
| ✅ 해야 할 일 | ❌ 하지 말아야 할 일 |
|------|---------|
| [모범 사례] | [안티패턴] |

### 코드 예제
[프레임워크에 맞는 코드 스니펫]

출력 — 확장

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

### 문제
[이 컴포넌트가 해결하는 사용자 니즈 또는 갭]

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

### 제안된 설계

#### API / 속성
| 속성 | 유형 | 기본값 | 설명 |
|----------|------|---------|-------------|
| [속성] | [유형] | [기본값] | [설명] |

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

#### 상태
| 상태 | 동작 | 참고 |
|-------|----------|-------|
| 기본 | [설명] | — |
| 호버 | [설명] | [상호작용] |
| 비활성 | [설명] | 상호작용 불가 |
| 로딩 | [설명] | [애니메이션] |

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

### 접근성
- **역할**: [ARIA 역할]
- **키보드**: [예상되는 상호작용]
- **스크린 리더**: [...

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

커넥터가 연결된 경우

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

  • 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

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

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

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.

관련 스킬