Communitygithub.com

프론트엔드 디자인 시스템

웹 UI를 위한 디자인 사고와 의사 결정. 컴포넌트, 레이아웃, 색 구성표, 타이포그래피를 디자인하거나 미적인 인터페이스를 만들 때 사용합니다. 고정된 값이 아닌 원칙을 가르칩니다.

프론트엔드 디자인 시스템란 무엇인가요?

이 스킬은 AI 에이전트(Claude Code, Cursor 등)가 웹 프론트엔드 디자인을 수행할 때 체계적이고 원칙 기반의 의사 결정을 할 수 있도록 설계된 종합적인 가이드입니다. 단순히 유행하는 디자인 패턴을 추천하는 것을 넘어, 사용자 심리학(Hick의 법칙, Fitts의 법칙 등), 색상 이론(60-30-10 규칙), 타이포그래피 규칙, 레이아웃 원리(황금비, 8포인트 그릿) 등 핵심 원칙을 가르칩니다. 특히 'Modern SaaS Safe Harbor'로 불리는 AI의 기본 설정 편향(예: 벤토 그리드, 유리 형태주의, 진한 시안/핀테크 블루)을 피하고, 프로젝트의 고유한 맥락과 사용자 요구에 따라 창의적인 결정을 내리도록 강조합니다. 파일 선택 규칙(필수/선택적 파일)과 '모호하면 질문하기' 원칙을 통해 효율적인 정보 탐색을 지원하며, ux_audit.py 스크립트를 통한 접근성 감사 기능도 제공합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/majiayu000/claude-skill-registry/tree/HEAD/skills/design/frontend-design-congdon1207-agents-md

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

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

문서

프론트엔드 디자인 시스템은(는) 무엇을 하나요?

철학: 모든 픽셀에는 목적이 있습니다. 절제는 사치입니다. 사용자 심리가 결정을 이끕니다. 핵심 원칙: 생각하세요, 외우지 마세요. 물어보세요, 추측하지 마세요.


🎯 선택적 읽기 규칙 (필수)

필수 파일은 항상 읽고, 선택적 파일은 필요할 때만 읽으세요:

파일상태읽을 때
ux-psychology.md🔴 필수항상 먼저 읽으세요!
color-system.md⚪ 선택색상/팔레트 결정 시
typography-system.md⚪ 선택글꼴 선택/조합 시
visual-effects.md⚪ 선택유리 형태주의, 그림자, 그라데이션 필요 시
animation-guide.md⚪ 선택애니메이션 필요 시
motion-graphics.md⚪ 선택Lottie, GSAP, 3D 필요 시
decision-trees.md⚪ 선택컨텍스트 템플릿 필요 시

🔴 ux-psychology.md = 항상 읽기. 나머지는 관련 있을 때만 읽기.


🔧 런타임 스크립트

감사를 위해 다음을 실행하세요 (읽지 말고, 그냥 실행):

스크립트목적사용법
scripts/ux_audit.pyUX 심리 및 접근성 감사python scripts/ux_audit.py <project_path>

⚠️ 중요: 추측하기 전에 물어보세요 (필수)

잠깐! 사용자의 요청이 열려 있다면, 기본 설정 값으로 바로 결정하지 마세요.

사용자 프롬프트가 모호할 때 물어보세요:

색상이 지정되지 않았나요? 물어보세요:

"어떤 색상 팔레트를 선호하시나요? (파란색/초록색/주황색/중립/기타?)"

스타일이 지정되지 않았나요? 물어보세요:

"어떤 스타일을 목표로 하시나요? (미니멀/대담/레트로/미래적/유기적?)"

레이아웃이 지정되지 않았나요? 물어보세요:

"레이아웃 선호도가 있으신가요? (단일 열/그리드/비대칭/전체 너비?)"

⛔ 피해야 할 기본 경향 (안전하지 않은 항구):

AI 기본 경향왜 나쁜가대신 생각할 것
벤토 그리드 (현대적 클리셰)모든 AI 디자인에서 사용됨이 콘텐츠에 그리드가 정말 필요한가?
히어로 분할 (좌/우)예측 가능하고 지루함대형 타이포그래피나 세로형 스토리텔링은 어떨까?
메쉬/오로라 그라데이션새로운 "게으른" 배경과감한 색상 조합은 무엇일까?
유리 형태주의AI가 "프리미엄"이라고 생각하는 것단색의 고대비 평면 디자인은 어떨까?
진한 시안 / 핀테크 블루보라색 금지 이후의 안전한 항구왜 빨간색, 검은색, 또는 네온 그린은 안 될까?
"조율하다 / 강화하다"AI 생성 카피라이팅인간은 이걸 어떻게 말할까?
어두운 배경 + 네온 글로우남용됨, "AI 스러움"브랜드가 실제로 필요한 것은 무엇인가?
모든 것을 둥글게평범함/안전함날카롭고 브루탈리즘적인 모서리는 어디에 쓸 수 있을까?

🔴 "당신이 선택하는 모든 '안전한' 구조는 당신을 평범한 템플릿에 한 걸음 더 가깝게 만듭니다. 위험을 감수하세요."


1. 제약 조건 분석 (항상 먼저)

디자인 작업 전에, 다음 질문에 답하거나 사용자에게 물어보세요:

제약 조건질문왜 중요한가
일정시간이 얼마나 있나요?복잡성 결정
콘텐츠준비되었나요, 아니면 임시인가요?레이아웃 유연성에 영향
브랜드기존 가이드라인이 있나요?색상/글꼴 결정 가능
기술어떤 스택인가요?기능에 영향
대상정확히 누구인가요?모든 시각적 결정을 이끔

대상 → 디자인 접근 방식

대상고려할 점
Z세대대담, 빠름, 모바일 우선, 진정성
밀레니얼깔끔, 미니멀, 가치 중심
X세대친숙함, 신뢰감, 명확함
베이비붐 세대가독성, 고대비, 단순함
B2B전문성, 데이터 중심, 신뢰
럭셔리절제된 우아함, 여백

2. UX 심리학 원칙

핵심 법칙 (내면화하세요)

법칙원리적용
힉의 법칙선택지가 많을수록 결정이 느려짐옵션 제한, 점진적 공개 사용
피츠의 법칙더 크고 가까울수록 클릭하기 쉬움CTA 크기를 적절히 설정
밀러의 법칙작업 기억 용량은 약 7개 항목콘텐츠를 그룹으로 묶기
폰 레스토르프 효과다르면 기억에 남음CTA를 시각적으로 차별화
위치 효과처음과 마지막이 가장 잘 기억됨핵심 정보는 처음과 끝에 배치

감성 디자인 수준

본능적 (즉각적)  → 첫인상: 색상, 이미지, 전반적인 느낌
행동적 (사용)    → 사용 시: 속도, 피드백, 효율성
반성적 (기억)    → 이후: "이 제품이 나에 대해 말해주는 것이 마음에 들어"

신뢰 구축

  • 민감한 작업에 보안 표시
  • 관련성이 있는 사회적 증거
  • 명확한 연락처/지원 접근성
  • 일관되고 전문적인 디자인
  • 투명한 정책

3. 레이아웃 원칙

황금비 (φ = 1.618)

비례적 조화를 위해 사용:
├── 콘텐츠 : 사이드바 = 대략 62% : 38%
├── 각 제목 크기 = 이전 크기 × 1.618 (극적인 스케일용)
├── 간격: sm → md → lg (각각 × 1.618)

8포인트 그리드 개념

모든 간격과 크기는 8의 배수:
├── 좁음: 4px (마이크로용 절반 단계)
├── 작음: 8px
├── 중간: 16px
├── 큼: 24px, 32px
├── 매우 큼: 48px, 64px, 80px
└── 콘텐츠 밀도에 따라 조정

주요 크기 조정 원칙

요소고려 사항
터치 대상최소 편안한 탭 크기
버튼중요도 계층에 따른 높이
입력 필드정렬을 위해 버튼 높이와 일치
카드일관된 패딩, 숨 쉬는 공간
읽기 너비45-75자가 최적

4. 색상 원칙

60-30-10 규칙

60% → 기본/배경 (차분하고 중립적인 베이스)
30% → 보조 (지원 영역)
10% → 강조 (CTA, 하이라이트, 주목)

색상 심리학 (의사 결정용)

필요한 효과고려할 색조피해야 할 것
신뢰, 평온파란색 계열공격적인 빨간색
성장, 자연초록색 계열산업적인 회색
에너지, 긴급주황색, 빨간색수동적인 파란색
럭셔리, 창의성진한 청록색, 금색, 에메랄드색싸구려 느낌의 밝은 색
깔끔, 미니멀중립색압도적인 색상

선택 프로세스

  1. 업계는 무엇인가요? (옵션 좁히기)
  2. 감정은 무엇인가요? (기본색 선택)
  3. 라이트 모드인가요, 다크 모드인가요? (기반 설정)
  4. 지정되지 않았다면 사용자에게 물어보세요

자세한 색상 이론은: color-system.md


5. 타이포그래피 원칙

스케일 선택

콘텐츠 유형스케일 비율느낌
조밀한 UI1.125-1.2컴팩트, 효율적
일반 웹1.25균형 잡힘 (가장 일반적)
에디토리얼1.333읽기 쉬움, 여유로움
히어로/디스플레이1.5-1.618극적인 효과

조합 개념

대비 + 조화:
├── 계층을 위해 충분히 다르게
├── 일관성을 위해 충분히 비슷하게
└── 일반적으로: 디스플레이 + 중립, 또는 세리프 + 산세리프

가독성 규칙

  • 줄 길이: 45-75자가 최적
  • 줄 높이: 본문 텍스트의 경우 1.4-1.6
  • 대비: WCAG 요구 사항 확인
  • 크기: 웹 본문은 16px 이상

자세한 타이포그래피는: typography-system.md


6. 시각적 효과 원칙

유리 형태주의 (적절한 경우)

핵심 속성:
├── 반투명 배경
├── 배경 흐림
├── 윤곽을 위한 미묘한 테두리
└── ⚠️ **경고:** 표준 파란색/흰색 유리 형태주의는 현대적 클리셰입니다. 과감하게 사용하거나 아예 사용하지 마세요.

그림자 계층

높이 개념:
├── 더 높은 요소 = 더 큰 그림자
├── Y-오프셋 > X-오프셋 (위에서 오는 빛)
├── 여러 레이어 = 더 사실적
└── 다크 모드: 그림자 대신 글로우가 필요할 수 있음

그라데이션 사용법

조화로운 그라데이션:
├── 색상환에서 인접한 색 (유사)
├── 또는 같은 색조, 다른 명도
├── 거친 보색 쌍 피하기
├── 🚫 **메쉬/오로라 그라데이션 사용 금지** (떠다니는 블롭)
└── 프로젝트마다 과감하게 변화시키기

전체 효과 가이드는: visual-effects.md


7. 애니메이션 원칙

타이밍 개념

지속 시간 기준:
├── 거리 (멀수록 = 더 길게)
├── 크기 (클수록 = 더 느리게)
├── 중요도 (중요할수록 = 더 명확하게)
└── 맥락 (긴급 = 빠르게, 고급 = 느리게)

이징 선택

동작이징이유
진입Ease-out감속, 안착
이탈Ease-in가속, 퇴장
강조Ease-in-out부드럽고 의도적
장난기Bounce재미, 활기

성능

  • transform과 opacity만 애니메이션 적용
  • reduced-motion 환경 설정 존중
  • 저사양 기기에서 테스트

애니메이션 패턴은: animation-guide.md, 고급은: motion-graphics.md


8. "와우 팩터" 체크리스트

프리미엄 지표

  • 충분한 여백 (럭셔리 = 숨 쉴 공간)
  • 미묘한 깊이와 입체감
  • 부드럽고 목적 있는 애니메이션
  • 세부 사항에 대한 주의 (정렬, 일관성)
  • 응집력 있는 시각적 리듬
  • 사용자 지정 요소 (기본값만 사용하지 않음)

신뢰 구축 요소

  • 적절한 위치에 보안 신호
  • 사회적 증거 / 사용 후기
  • 명확한 가치 제안
  • 전문적인 이미지
  • 일관된 디자인 언어

감정 유발 요소

  • 의도된 감정을 불러일으키는 히어로
  • 인간적 요소 (얼굴, 이야기)
  • 진행/성취 표시기
  • 기쁨의 순간

9. 안티 패턴 (하지 말아야 할 것)

❌ 게으른 디자인 지표

  • 고려 없이 기본 시스템 글꼴 사용
  • 어울리지 않는 스톡 이미지
  • 일관성 없는 간격
  • 너무 많은 경쟁 색상
  • 계층 없이 텍스트 벽을 세우기
  • 접근 불가능한 대비

❌ AI 경향 패턴 (피하세요!)

  • 모든 프로젝트에 같은 색상
  • 어두움 + 네온을 기본값으로
  • 모든 것에 보라색/바이올렛 (보라색 금지 ✅)
  • 단순한 랜딩 페이지에 벤토 그리드
  • 메쉬 그라데이션 & 글로우 효과
  • 동일한 레이아웃 구조 / Vercel 클론
  • 사용자 선호도를 묻지 않음

❌ 다크 패턴 (비윤리적)

  • 숨겨진 비용
  • 가짜 긴급성
  • 강제적인 행동
  • 기만적인 UI
  • 확인 샤밍

10. 의사 결정 프로세스 요약

모든 디자인 작업에 대해:

1. 제약 조건
   └── 일정, 브랜드, 기술, 대상은 무엇인가요?
   └── 불명확하면 → 물어보세요

2. 콘텐츠
   └── 어떤 콘텐츠가 있나요?
   └── 계층 구조는 무엇인가요?

3. 스타일 방향
   └── 맥락에 적합한 것은 무엇인가요?
   └── 불명확하면 → 물어보세요 (기본값을 사용하지 마세요!)

4. 실행
   └── 위의 원칙 적용
   └── 안티 패턴 확인

5. 검토
   └── "이것이 사용자에게 도움이 되나요?"
   └── "이것이 내 기본값과 다른가요?"
   └── "이것에 대해 자랑스러울 수 있나요?"

참조 파일

특정 영역에 대한 더 깊은 지침은:


관련 스킬

스킬사용 시기
frontend-design (현재)코딩 전 - 디자인 원칙 학습 (색상, 타이포그래피, UX 심리학)
web-design-guidelines코딩 후 - 접근성, 성능, 모범 사례 감사

디자인 후 워크플로우

디자인을 구현한 후 감사를 실행하세요:

1. 디자인  → frontend-design 원칙 읽기 ← 여기 있음
2. 코딩    → 디자인 구현
3. 감사    → web-design-guidelines 검토 실행
4. 수정    → 감사 결과 처리

다음 단계: 코딩 후 web-design-guidelines 스킬을 사용하여 접근성, 포커스 상태, 애니메이션 및 성능 문제에 대한 구현을 감사하세요.


기억하세요: 디자인은 복사가 아니라 생각하는 것입니다. 모든 프로젝트는 고유한 맥락과 사용자를 기반으로 새로운 고려가 필요합니다. Modern SaaS Safe Harbor를 피하세요!

Individual skills in this repo

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

majiayu000/claude-skill-registry

Builds, edit or validate Agent Skill through conversational discovery. Use when the user requests to "Create an Agent", "Optimize an Agent" or "Edit an Agent".

majiayu000/claude-skill-registry

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry

Analyzes current state and user query to answer BMad questions or recommend the next workflow or agent. Use when user says what should I do next, what do I do now, or asks a question about BMad

majiayu000/claude-skill-registry

Build AI agents with Google ADK Python (Agent Development Kit). Use for multi-agent systems, workflow agents (sequential/parallel/loop), Vertex AI deployment, tool integration, human-in-the-loop.

majiayu000/claude-skill-registry

Build AI agents with Google ADK Python (Agent Development Kit). Use for multi-agent systems, workflow agents (sequential/parallel/loop), Vertex AI deployment, tool integration, human-in-the-loop.

majiayu000/claude-skill-registry

Portfolio allocation and rebalancing optimizer. Manages asset allocation across stocks/cash/bonds, performs periodic rebalancing, and ensures diversification according to market regime and risk tolerance.

majiayu000/claude-skill-registry

Create a hilarious and ultra-realistic video of an anthropomorphic animal acting like a human vlogger in a real-world setting.

majiayu000/claude-skill-registry

Speech-to-text transcription and translation via OpenAI Audio API -- models, response formats, timestamps, prompting, streaming, chunking, and diarization

majiayu000/claude-skill-registry

BlockRun works with Claude Code and Google Antigravity.

majiayu000/claude-skill-registry

This skill should be used when the user asks about libraries, frameworks, API references, or needs code examples. Activates for setup questions, code generation involving libraries, or mentions of specific frameworks like React, Vue, Next.js, Prisma, Supabase, etc.

majiayu000/claude-skill-registry

小省导购员数字人带货版即梦视频提示词生成系统,基于四大智能体协同(提示词生成师、质量管控师、知识库运维师、跨环节适配师),按照"主体+运动+场景+(镜头语言+光影+氛围)"公式输出中英文双版提示词,适配5s短视频。确保人物一致性、视觉连贯性、情绪连贯性,支持知识库智能复用和跨工具适配(Suno音乐、AI绘画),为数字人带货视频提供高质量提示词生成服务。

majiayu000/claude-skill-registry

Upload and manage files using Google Gemini File API via scripts/. Use for uploading images, audio, video, PDFs, and other files for use with Gemini models. Supports file upload, status checking, and file management. Triggers on "upload file", "file API", "upload image", "upload PDF", "upload video", "file management".

majiayu000/claude-skill-registry

CRITICAL: Use for MolyKit AI chat toolkit. Triggers on: BotClient, OpenAI, SSE streaming, AI chat, molykit, PlatformSend, spawn(), ThreadToken, cross-platform async, Chat widget, Messages, PromptInput, Avatar, LLM

majiayu000/claude-skill-registry

AI and machine learning workflow covering LLM application development, RAG implementation, agent architecture, ML pipelines, and AI-powered features.

majiayu000/claude-skill-registry

Analyze images/audio/video with Gemini API (better vision than Claude). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.

majiayu000/claude-skill-registry

Analyze images/audio/video with Gemini API (better vision than Claude). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.

majiayu000/claude-skill-registry

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

관련 스킬