Communitygithub.com

kumaran-is/claude-code-onboarding

독창적인 프론트엔드 디자인 스킬. 의도적인 미학으로 차별화된 프로덕션급 인터페이스를 구축합니다. DFII 점수 평가(코딩 전 게이트), 필수 디자인 사고 단계(목적→톤→차별화 앵커), 요구되는 출력 구조(디자인 방향 요약, 디자인 시스템 스냅샷, 차별화 코멘트) 및 운영자 체크리스트를 포함합니다. 웹/모바일 UI 컴포넌트, 페이지 또는 대시보드를 구축하거나 스타일링할 때 사용하세요.

claude-code-onboarding란 무엇인가요?

이 스킬은 Claude가 창의적인 프론트엔드 디자인을 수행할 수 있는 방법론을 제공합니다. 핵심은 코드를 작성하기 전에 반드시 디자인 사고 단계를 완료해야 한다는 '철칙'입니다. 이 단계에서는 인터페이스의 목적, 지배적인 톤, 그리고 차별화 앵커를 정의합니다. 이후 DFII(디자인 실현 가능성 및 영향 지수)를 계산하여 디자인 방향의 타당성을 평가하며, 최소 8점 이상을 받아야 실제 코딩을 진행할 수 있습니다. 스킬은 Angular, Flutter, HTML/CSS/JS 등 다양한 스택을 지원하며, 각 스택에 맞는 디자인 토큰 규칙(예: Angular용 daisyUI, Flutter용 colorScheme)을 준수하도록 안내합니다. 최종 결과물은 디자인 방향 요약, 디자인 시스템 스냅샷, 실제 구현 코드, 그리고 '이것이 일반적인 UI와 다른 점'을 명시하는 차별화 코멘트를 포함해야 합니다. 또한 '공간 그로테스크', '보라색 그라디언트'와 같은 흔한 선택을 피하고, 매번 새로운 미학적 DNA를 가진 디자인을 만들도록 강조합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/kumaran-is/claude-code-onboarding/tree/HEAD/.claude/skills/frontend-design

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

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

문서

철칙

디자인 사고 단계를 완료하지 않고 UI를 출력하지 마십시오 — 코드 한 줄을 작성하기 전에 목적, 톤(한 방향), 차별화 앵커를 정의하십시오. 진행하려면 DFII 점수가 8 이상이어야 합니다.

프론트엔드 디자인 스킬

목적

창의적인 프론트엔드 디자인 방법론, 시각적 원칙 및 품질 체크리스트를 제공하여 일반적인 AI 미학을 피하는 차별화된 프로덕션급 인터페이스를 구축합니다.

프로세스

  1. 디자인 사고 단계 (필수 — 건너뛰지 마십시오)
    • 목적 정의: 이 인터페이스는 어떤 행동을 가능하게 합니까? 설득력, 기능적, 탐색적, 표현적 중 무엇입니까?
    • 톤 정의: 하나의 지배적인 방향을 선택하십시오(브루탈리즘 / 에디토리얼 / 럭셔리 / 레트로-퓨처리스틱 / 인더스트리얼 / 오가닉 / 플레이풀 / 맥시멀리스트 / 미니멀리스트). 두 개 이상 혼합하지 마십시오.
    • 차별화 앵커 정의: "로고가 제거된 스크린샷이라면 어떻게 알아볼 수 있습니까?"라는 질문에 답하십시오. 이것이 최종 UI에 보여야 합니다.
  2. DFII 점수 매기기 — 디자인 실현 가능성 및 영향 지수 계산(아래 참조). 점수가 8 미만이면 진행 전에 방향을 재고하십시오.
  3. 원칙 로드 -- reference/frontend-design-principles.md를 읽어 타이포그래피, 색상, 모션 및 레이아웃 지침을 확인하십시오.
  4. 구현 -- 선택한 미학에 맞춰 작동하는 코드(Angular, Flutter 또는 HTML/CSS/JS)를 빌드하십시오. 작업 공간 디자인 토큰(Angular용 daisyUI, Flutter용 AppSpacing/colorScheme)을 따르십시오.
  5. 필요한 출력 구조로 전달 -- 디자인 방향 요약, 디자인 시스템 스냅샷, 구현 및 차별화 코멘트를 포함하십시오.

전체 디자인 원칙, 안티-패턴 및 품질 체크리스트를 보려면:

reference/frontend-design-principles.md를 읽으십시오.

오류 처리

대상 프레임워크가 지정되지 않은 경우 진행 전에 사용자에게 물어보십시오. 외부 글꼴/에셋 리소스를 사용할 수 없는 경우 대체 선택을 문서화하고 계속하십시오.

디자인 실현 가능성 및 영향 지수 (DFII)

코드를 작성하기 전에 디자인 방향에 점수를 매기십시오. 진행하려면 최소 8점이 필요합니다.

차원 (각 1~5점)

차원질문
미학적 영향이 방향이 시각적으로 얼마나 독특하고 기억에 남는가?
맥락 적합성이 미학이 제품, 대상 및 목적에 적합한가?
구현 실현 가능성사용 가능한 기술로 깔끔하게 구축할 수 있는가?
성능 안전성빠르고 접근성을 유지할 수 있는가?
일관성 리스크화면/컴포넌트에서 유지 관리할 수 있는가? (이것을 차감)

공식

DFII = (영향 + 적합성 + 실현 가능성 + 성능) − 일관성 리스크
범위: −5 → +15

해석

DFII의미조치
12–15우수완전히 실행
8–11강력규율을 가지고 진행
4–7위험범위 또는 효과 축소
≤ 3약함미학 방향 재고

요구되는 출력 구조

모든 프론트엔드 디자인 출력은 다음 네 개의 섹션을 모두 포함해야 합니다:

1. 디자인 방향 요약

  • 미학 이름 (예: "에디토리얼 브루탈리즘", "럭셔리 미니멀")
  • DFII 점수
  • 주요 영감 (개념적 — 시각적 표절 금지)

2. 디자인 시스템 스냅샷

  • 글꼴 (근거 포함 — 이 제품에 왜 이 글꼴인가?)
  • 색상 변수 (이름 지정: --color-primary, --color-accent, --color-neutral)
  • 간격 리듬 (기본 단위 및 척도)
  • 모션 철학 (드물게/의도적으로? 또는 없음?)

3. 구현

  • 완전한 작동 코드
  • 의도가 명확하지 않은 경우에만 주석
  • Angular의 경우: daisyUI 시맨틱 토큰 사용 (bg-primary, text-base-content) — 하드코딩된 16진수 금지
  • Flutter의 경우: Theme.of(context).colorScheme 및 AppSpacing.* 토큰 사용 — Color(0xFF...) 금지

4. 차별화 코멘트

명시적으로 명시:

"이것은 Y 대신 X를 함으로써 일반적인 UI를 피합니다."

이 문장을 완성할 수 없다면 디자인이 충분히 차별화되지 않은 것입니다.


운영자 체크리스트 (전달 전 게이트)

  • 디자인 사고 단계 완료 (목적 + 톤 + 차별화 앵커 정의)
  • DFII 점수 ≥ 8
  • 최종 UI에 기억에 남는 디자인 앵커 하나가 보임
  • 일반적인 글꼴 없음 (Inter, Roboto, Arial, system-ui 금지)
  • 일반적인 색상 없음 (보라색-흰색 그라디언트, 평평한 회색 금지)
  • 기본 레이아웃 없음 (대칭형 카드 그리드, 템플릿형 구조 금지)
  • 코드가 디자인 야망과 일치 (맥시멀리스트 = 복잡한 코드; 미니멀리스트 = 정확한 간격)
  • 접근 가능하고 성능이 좋음 (대비 ≥ 4.5:1, 포커스 상태, 키보드 내비게이션)
  • 요구되는 출력 구조: 4개 섹션 모두 존재
  • 이전 디자인과 비슷해 보이지 않아야 함 — 밝음/어두움, 글꼴 선택, 레이아웃 개성을 다양화

창의적 야망 명령

Claude는 뛰어난 창의적 작업을 할 수 있습니다. 망설이지 말고 — 독특한 비전에 온전히 헌신하여 진정으로 창조할 수 있는 것을 보여주십시오.

요구 사항을 창의적으로 해석하십시오. 맥락에 대해 진정으로 설계된 느낌을 주는 예상치 못한 선택을 하십시오. 두 디자인이 동일한 미학적 DNA를 공유해서는 안 됩니다.

세대를 걸쳐 일반적인 선택에 수렴하지 마십시오. Space Grotesk, 보라색 그라디언트 또는 대칭형 히어로 레이아웃이 "이전에 효과가 있었다"는 사실은 정확히 다시 사용하지 말아야 하는 이유입니다. 다양성은 선택 사항이 아니라 필수입니다.


시작 전 물어볼 질문 (필요한 경우)

  1. 이것은 감정적으로 누구를 위한 것입니까?
  2. 신뢰감, 흥미, 평온함 또는 도발적으로 느껴져야 합니까?
  3. 기억에 남는 것이 더 중요합니까, 명확성이 더 중요합니까?
  4. 이것이 다른 페이지/컴포넌트로 확장될 수 있습니까?
  5. 사용자가 처음 3초 안에 무엇을 느껴야 합니까?

작업 공간 통합

스택디자인 토큰 규칙참고 자료
AngulardaisyUI 시맨틱 토큰만 사용 — bg-primary, text-base-content, border-base-300angular-spa/reference/daisyui-v5-components.md
FlutterTheme.of(context).colorScheme.* + AppSpacing.* — 절대 Color(0xFF...) 또는 EdgeInsets.all(16) 사용 금지ui-standards-tokens/reference/ui-design-tokens.md
HTML/CSSCSS 변수만 사용 — var(--color-primary):root 블록에 정의
React Native이 스킬의 범위 밖 → mobile-developer 스킬 사용.claude/skills/mobile-developer/SKILL.md

관련 스킬:

  • web-design-guidelines — 구현 후 실행하여 Vercel 웹 인터페이스 가이드라인 감사
  • design-system — Angular 및 Flutter용 토큰 컴플라이언스 시행
  • angular-spa — daisyUI를 사용한 Angular 구현 패턴
  • ui-standards-tokens — Flutter 디자인 토큰 정의

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬