Communitygithub.com

디자인 시스템 — 시각 시스템 생성 및 감사

이 스킬을 사용하여 디자인 시스템을 생성하거나 감사하고, 시각적 일관성을 확인하며, 스타일 관련 PR을 검토하세요. 디자인 시스템 생성 또는 감사, 시각적 일관성 확인, 스타일링이 포함된 PR 리뷰 시 사용합니다.

디자인 시스템 — 시각 시스템 생성 및 감사란 무엇인가요?

이 스킬은 개발자가 디자인 시스템을 생성, 감사, 그리고 시각적 일관성을 유지할 수 있도록 지원하는 전문 도구입니다. Claude Code, Cursor, Codex와 같은 AI 에이전트 환경에서 사용할 수 있으며, 세 가지 주요 모드로 작동합니다. 첫 번째 모드는 코드베이스를 분석하여 CSS, Tailwind, styled-components에서 추출한 패턴을 바탕으로 일관된 디자인 시스템을 생성하고, DESIGN.md, design-tokens.json, design-preview.html 파일을 출력합니다. 두 번째 모드는 UI를 10가지 차원(컬러 일관성, 타이포그래피 계층, 간격 리듬 등)에서 0~10점으로 점수를 매기고 구체적인 예시와 수정 사항을 파일:줄 번호와 함께 제공합니다. 세 번째 모드는 ‘AI 슬롭’ 감지 기능을 통해 그라데이션 남용, 무광택 카드 등의 일반적인 AI 생성 디자인 패턴을 식별합니다. 이 스킬은 새 프로젝트 시작, 코드베이스 감사, 리디자인 전 분석, UI가 어색할 때, 스타일 PR 리뷰에 특히 유용합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/affaan-m/everything-claude-code/tree/main/skills/design-system

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

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

문서

디자인 시스템 — 시각 시스템 생성 및 감사은(는) 무엇을 하나요?

사용 시기

  • 디자인 시스템이 필요한 새 프로젝트를 시작할 때
  • 기존 코드베이스의 시각적 일관성을 감사할 때
  • 리디자인 전 — 현재 상태를 파악해야 할 때
  • UI가 "어색"하지만 정확한 원인을 찾기 어려울 때
  • 스타일링이 포함된 PR을 검토할 때

작동 방식

모드 1: 디자인 시스템 생성

코드베이스를 분석하고 일관된 디자인 시스템을 생성합니다:

1. CSS/Tailwind/styled-components에서 기존 패턴 스캔
2. 추출: 색상, 타이포그래피, 간격, 테두리 반경, 그림자, 중단점
3. 브라우저 MCP를 통해 경쟁사 사이트 3곳 조사 (영감 획득)
4. 디자인 토큰 세트 제안 (JSON + CSS 사용자 정의 속성)
5. 각 결정에 대한 근거가 포함된 DESIGN.md 생성
6. 대화형 HTML 미리보기 페이지 생성 (자체 포함, 종속성 없음)

출력: DESIGN.md + design-tokens.json + design-preview.html

모드 2: 시각 감사

UI를 10가지 차원에서 채점합니다 (각 0-10점):

1. 색상 일관성 — 팔레트를 사용하고 있나요, 아니면 무작위 헥스 값인가요?
2. 타이포그래피 계층 — h1 > h2 > h3 > 본문 > 캡션이 명확한가요?
3. 간격 리듬 — 일관된 단위(4px/8px/16px)인가요, 아니면 임의적인가요?
4. 컴포넌트 일관성 — 비슷한 요소들이 비슷하게 보이나요?
5. 반응형 동작 — 중단점에서 유연한가요, 아니면 깨지나요?
6. 다크 모드 — 완전하게 구현되었나요, 아니면 반만 되었나요?
7. 애니메이션 — 목적이 있나요, 아니면 과도한가요?
8. 접근성 — 대비 비율, 포커스 상태, 터치 대상
9. 정보 밀도 — 복잡한가요, 아니면 깔끔한가요?
10. 정교함 — 호버 상태, 전환, 로딩 상태, 빈 상태

각 차원마다 점수, 구체적인 예시, 그리고 정확한 파일:줄 위치와 함께 수정 사항이 제공됩니다.

모드 3: AI 슬롭 감지

일반적인 AI 생성 디자인 패턴을 식별합니다:

- 모든 곳에 과도한 그라데이션 사용
- 보라색에서 파란색으로의 기본값
- 목적 없는 "유리 모피즘" 카드
- 둥글게 처리할 필요가 없는 요소의 둥근 모서리
- 스크롤 시 과도한 애니메이션
- 기본 그라데이션 배경 위에 중앙 정렬 텍스트가 있는 일반적인 히어로
- 개성이 없는 산세리프 글꼴 스택

예시

SaaS 앱용 생성:

/design-system generate --style minimal --palette earth-tones

기존 UI 감사:

/design-system audit --url http://localhost:3000 --pages / /pricing /docs

AI 슬롭 확인:

/design-system slop-check

Individual skills in this repo

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

accessibility

Design, implement, and audit inclusive digital products using WCAG 2.2 Level AA. Use when building or auditing UI that must meet WCAG 2.2 Level AA, or when reviewing a change for keyboard, contrast, or screen-reader support.

affaan-m/claude-api

Anthropic Claude API patterns for Python and TypeScript. Covers Messages API, streaming, tool use, vision, extended thinking, batches, prompt caching, and Claude Agent SDK. Use when building applications with the Claude API or Anthropic SDKs.

affaan-m/everything-claude-code

End-to-end marketing campaign planning and execution. Covers audience research, positioning, campaign angle definition, landing page copy, email sequences, social posts, ad copy, short-form video scripts, and content calendars. Use as the orchestration layer for multi-channel product launches. Use when planning or executing a multi-channel product launch, or producing landing page, email, social, or ad copy.

affaan-m/everything-claude-code

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/everything-claude-code-conventions

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/frontend-design

Create distinctive, production-grade frontend interfaces with high design quality. Use when the user asks to build web components, pages, or applications and the visual direction matters as much as the code quality.

affaan-m/gget

gget CLI and Python workflow for quick genomic database queries, sequence lookup, BLAST-style searches, enrichment checks, and reproducible bioinformatics evidence logs.

affaan-m/literature-review

Systematic literature-review workflow for academic, biomedical, technical, and scientific topics, including search planning, source screening, synthesis, citation checks, and evidence logging.

affaan-m/motion-ui

Production-ready UI motion system for React/Next.js. Use when implementing animations, transitions, or motion patterns.

affaan-m/project-guidelines-example

Example project-specific skill template based on a real production application.

affaan-m/pubmed-database

Direct PubMed and NCBI E-utilities search workflows for biomedical literature, MeSH queries, PMID lookup, citation retrieval, and API-backed literature monitoring.

affaan-m/scholar-evaluation

Structured scholarly-work evaluation for papers, proposals, literature reviews, methods sections, evidence quality, citation support, and research-writing feedback.

affaan-m/uspto-database

USPTO patent and trademark data workflow for official record lookup, PatentSearch queries, TSDR checks, assignment data, and reproducible IP research logs.

agent-architecture-audit

Full-stack diagnostic for agent and LLM applications. Audits the 12-layer agent stack for wrapper regression, memory pollution, tool discipline failures, hidden repair loops, and rendering corruption. Produces severity-ranked findings with code-first fixes. Essential for developers building agent applications, autonomous loops, or any LLM-powered feature. Use when an agent or LLM feature misbehaves and the failing layer is unknown, or before shipping an agent stack.

agent-eval

Head-to-head comparison of coding agents (Claude Code, Aider, Codex, etc.) on custom tasks with pass rate, cost, time, and consistency metrics. Use when choosing between coding agents, or when a change to an agent setup needs measured pass rate, cost, and time rather than an impression.

agent-harness-construction

Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates. Use when defining or revising an agent

agentic-engineering

Operate as an agentic engineer using eval-first execution, decomposition, and cost-aware model routing. Use when planning or executing engineering work that agents will carry out end to end.

agentic-os

Build persistent multi-agent operating systems on Claude Code. Covers kernel architecture, specialist agents, slash commands, file-based memory, scheduled automation, and state management without external databases. Use when building a persistent multi-agent system on Claude Code with its own memory, commands, and scheduling.

agent-introspection-debugging

Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports. Use when an agent run fails and you need a reproducible diagnosis instead of a retry.

agent-payment-x402

Add x402 payment execution to AI agents with per-task budgets, spending controls, and non-custodial wallets. Supports Base through agentwallet-sdk and X Layer through OKX Payments / OKX Agent Payments Protocol. Use when an agent must pay for something itself and needs per-task budgets, spending controls, and a non-custodial wallet.

관련 스킬