사용 가이드로 건너뛰기
interface-design작성자 Dammyjay93

Interface Design 스킬.

UI 디자인을 위한 Claude Code 및 Codex skill: 대시보드, 관리 패널, SaaS 도구 및 설정 페이지를 위한 정교한 인터페이스 디자인.

  • Web & UI
  • UI 코드
Dammyjay93/interface-design · .claude/skills/interface-design/SKILL.mdSKILL.md
--- name: interface-design description: Craft-first interface design for dashboards, admin panels, SaaS apps, tools, settings pages, data interfaces, and interactive products. Use when designing, building, reviewing, auditing, or refining product UI where visual craft, layout hierarchy, tokens, states, visual direction, or design-system consistency matter. Not for marketing pages, landing pages, campaigns, or brand-only work. --- ## Scope ## One focal point per view ## Type scale is a ratio, and weight beats size ## Density is a decision, expressed in px ## Spatial rhythm — breathe unevenly ## Proportions speak
업스트림 파일에서 읽은 앞부분 및 섹션 제목, 2026-09-14 · 전체 29,304자

01 기능

Claude Code와 Codex에서 interface-design 스킬이 하는 일

요약, 워크플로, 산출물을 모두 해당 스킬의 SKILL.md에서 그대로 읽어 정리한 내용입니다.

SKILL.md에서2026-09-14 읽음 · 실행 기록 아님

스킬 자체의 표현으로

대시보드, 관리자 패널, SaaS 앱, 도구, 설정 페이지, 데이터 인터페이스 등 제품 UI를 최상위 디자인 팀이 내릴 결정과 같은 수준으로 구축하는, 크래프트를 최우선으로 하는 원칙입니다. 코드를 작성하기 전에 작동하는 브리프를 먼저 만들도록 강제합니다: 사용자가 누구인지, 그들이 하러 온 단 하나의 동작이 무엇인지, 그리고 인터페이스가 의미 있는 말로 어떤 느낌을 주어야 하는지를 정의합니다.

이어서 도메인 탐색(도메인, 컬러 월드, 시그니처, 배제된 기본값), 비율 기반 타입 스케일과 위계를 담당하는 굵기·색상, 하나로 확정된 깊이 전략, 하드코딩된 리터럴이 아닌 시맨틱 토큰, 그리고 마무리와 모션에 관한 필수 요소들—탭 숫자, 동심 반경, 300ms 이하의 지속 시간, 고빈도 동작에는 애니메이션을 넣지 않는 것—을 규정합니다. 랜딩 페이지, 마케팅 사이트, 캠페인 또는 브랜드 전용 작업에는 명확히 적용되지 않습니다.

산출물

  • 도메인, 컬러 월드, 시그니처, 배제, 방향을 명시하는 Suggest + Ask 제안입니다.
  • 렌더링 도구가 있을 경우, 팔레트 스와치, 실제 서체로 표현된 타입 스케일, 스택형 엘리베이션 카드, 실제 컴포넌트로 구현된 시그니처 등 인라인으로 렌더링된 샘플입니다. 구현 자체는 여전히 코드베이스에 반영됩니다.
  • 방향, 깊이 전략, 위계 결정, 반복되는 컴포넌트 패턴을 담은 .interface-design/system.md 파일로, 사용자가 승인한 뒤에만 저장됩니다.
예시 프롬프트 보기 ↗

작동 방식

  1. 01
    작업 브리프 작성

    코드를 작성하기 전에, 사용자가 누구인지, 어떤 동작을 수행해야 하는지, 인터페이스가 어떤 느낌을 주어야 하는지에 답합니다—방향 확인이 필요한 경우가 아니면 간결하게 유지합니다.

  2. 02
    제품 도메인 탐색

    방향을 제안하기 전에 네 가지 결과물을 만듭니다: 최소 5개의 도메인 개념, 제품이 속한 물리적 세계에서 나온 5개 이상의 색상, 하나의 시그니처 요소, 그리고 배제할 명백한 기본값 3가지입니다.

  3. 03
    방향 제안 및 확인

    도메인, 컬러 월드, 시그니처, 배제, 방향을 명시하는 Suggest + Ask 블록으로 시작한 다음, 구현에 들어가기 전 방향이 적절한지 확인합니다.

  4. 04
    가능한 경우 샘플을 렌더링

    세션에 인라인 시각 렌더링 도구가 있다면, 팔레트, 타입 스케일, 엘리베이션 단계, 시그니처를 설명 대신 실제 컴포넌트로 보여줍니다. 그렇지 않으면 코드로 대체합니다.

  5. 05
    기존 요소를 기반으로 구현한 뒤 검증

    앱, 토큰, 컴포넌트 패턴, system.md를 확인하고, 구현을 수정하고, 가능한 경우 빌드, 타입 체크 또는 테스트를 실행한 다음 데스크톱과 모바일 폭에서 시각적으로 검증합니다.

  6. 06
    패턴 저장 제안

    작업 후, 이후 세션에서도 일관성을 유지할 수 있도록 방향, 깊이 전략, 위계 결정, 반복되는 컴포넌트 패턴을 기록할지 제안합니다.

02 적합성 확인

interface-design Skill을 사용해야 하는 경우

이러한 종류의 UI 디자인 작업에는 Claude Code 또는 Codex에서 interface-design 스킬을 사용하십시오. 적합성과 제한 사항은 스킬 자체 파일에서 가져왔습니다.

적합한 경우

  • 제품 UI 작업: 대시보드, 관리자 패널, SaaS 앱, 도구, 설정 페이지 및 데이터 인터페이스.
  • 새로운 화면 구축뿐 아니라 기존 제품 UI의 검토, 감사 또는 개선 작업.
  • 새로 시작하는 화면, 대규모 리디자인, 방향이 모호한 경우로, 시각적 레퍼런스 작업이 코드 작성보다 먼저 이루어질 수 있습니다.
  • 새로운 작업에서도 기존 system.md에 명시된 값을 그대로 준수합니다.

한계 인지하기

  • 랜딩 페이지, 마케팅 사이트, 캠페인, 브랜드 전용 작업은 이 파일이 대신 마케팅 또는 프런트엔드 디자인 스킬로 넘깁니다.
  • 생성된 이미지 에셋은 빈 상태 아트와 텍스처만 다루며, 아이콘, 로고 또는 차트는 다루지 않습니다.
  • 네이티브 select 및 date 입력은 스타일링이 불가능하므로, 직접 만든 것이 아니라 헤드리스 프리미티브로 대체해야 합니다.
  • 인라인 렌더링은 조건부입니다: CI, 헤드리스 에이전트 또는 단순 터미널에서는 위젯이 없으므로, 스킬은 코드, 토큰, 서면 제안으로 대체됩니다.

제공할 사항

  • 사람, 동사, 그리고 느낌브리프는 인터페이스를 여는 사람이 누구인지, 무엇을 달성해야 하는지, 그리고 어떤 느낌이어야 하는지를 의미 있는 단어로 명시해야 합니다. 그렇지 못한 경우 스킬은 간결한 질문 하나를 던지거나 책임 있는 가정을 세우고 진행합니다.
  • 기존 코드베이스기존 앱, 디자인 토큰, 컴포넌트 패턴, .interface-design/system.md를 검토하여 컨트롤과 스타일을 재발명하지 않고 재사용합니다.
  • 페인트오버용 스크린샷이미지 생성 도구를 사용할 수 있는 경우, 코드를 작성하기 전에 기존 스크린샷을 더 강력한 버전으로 바꿀 수 있습니다.

03 스킬 내부

interface-design 스킬이 Claude Code와 Codex에 제공하는 규칙

SKILL.md가 에이전트에게 설정하는 8가지 구체적인 지시, 기본값, 제한 — 결과를 바꾸는 파일의 부분입니다.

  1. 코드 작성 전 체크포인트 실행

    작은 추가 사항이라도 UI 코드를 작성하기 전에 Intent, Hierarchy, Palette, Depth, Surfaces, Typography, Spacing을 명시하고, 각각에 대해 이유를 말할 수 있어야 합니다.

  2. 네이티브, 그다음 프리미티브, 그다음 직접 구현

    플랫폼이 이미 버튼이나 링크를 제공하는 경우 onClick이 있는 div를 절대 만들지 마십시오. select, combobox, dialog, popover, tooltip, tabs, date picker와 같은 상태를 가진 컨트롤은 검증된 headless 프리미티브에서 가져와야 합니다.

  3. 하드코딩된 리터럴 대신 토큰 사용

    스타일링은 bg-white, border-gray-200, text-gray-500가 아니라 bg-card, border-border, text-muted-foreground와 같은 시맨틱 토큰에 바인딩해야 합니다. 하드코딩된 값은 테마 설정과 다크 모드를 깨뜨립니다.

  4. 느낌이 아니라 비율로 타이포그래피 단계 설정

    비율 하나를 정하고 그것을 단계적으로 적용하십시오: 밀도가 높거나 차분한 UI는 약 1.2, 대부분의 제품 UI는 1.25, 표현력이 필요한 경우 1.333을 사용하며, 14~16px의 본문 크기에서 시작하여 스페이싱 그리드 상의 정수 픽셀로 반올림합니다.

  5. 정확히 하나의 깊이 전략에 전념하기

    보더만 사용, 은은한 섀도, 레이어드 섀도, 표면 색상 변화 중 하나를 선택하고 어디에서나 이를 유지하십시오. 전략을 혼용하는 것은 피해야 할 사항에 포함됩니다.

  6. UI 모션은 300ms 이내로 유지

    버튼 누름은 100~160ms, 툴팁과 팝오버는 125~200ms, 드롭다운은 150~250ms로 하고, 약한 기본 제공 커브나 ease-in 대신 커스텀 ease-out을 사용합니다.

  7. 반복되는 동작에는 애니메이션을 적용하지 않음

    하루에 100회 이상 수행되는 동작 — 키보드 단축키, 커맨드 팔레트 — 은 느리게 느껴지므로 애니메이션을 전혀 적용하지 않습니다. 모달, 드로어, 토스트는 여전히 표준 애니메이션을 적용합니다.

  8. 스케일 0에서 애니메이션을 시작하지 않음

    등장 애니메이션은 스케일 0.95, 오파시티 0에서 시작합니다. 아무것도 무(無)에서 나타날 수 없기 때문입니다.

04 활용하기

Claude Code 또는 Codex에 interface-design 설치

npx skills add 명령 한 번 실행 후, 에이전트에서 첫 번째 작업을 수행하고 결과 체크리스트를 확인합니다.

Claude Code, Codex 또는 사용 중인 Agent에 interface-design 추가

프로젝트에서 실행합니다. 설치 프로그램이 어떤 에이전트에 추가할지 묻습니다.

Terminal
npx skills add https://github.com/Dammyjay93/interface-design --skill interface-design

.claude/skills/interface-design/SKILL.md에 대한 일반적인 skills CLI 형식이며, 저장소에서 자체 경로를 문서화할 수도 있습니다.

스킬에 첫 UI 디자인 작업 부여하기

스킬 자체의 용어로 작성되었습니다. 대괄호 부분은 각자의 자료로 교체합니다.

Starter prompt
Build the settings page for [product], a SaaS tool. [The person] opens it to [task], and it should feel [feel], not like a generic admin panel. Our tokens and components live in [existing design system], so reuse those. The focal element is [focal element], and it needs loading, empty and error states.

출처: 스킬 자체의 용어로 SKILL.md에서 작성했습니다.

첫 번째 결과 확인

SKILL.md 자체가 올바른 결과의 모습으로 제시하는 내용:

  • 스왑 테스트 — 서체를 흔히 쓰는 서체로, 레이아웃을 표준 템플릿으로 바꿔 보십시오. 아무것도 달라지지 않는 부분이 바로 기본값에 의존한 지점입니다.
  • 스퀸트 테스트 — 눈을 가늘게 뜨고 흐릿하게 보십시오. 계층 구조는 여전히 읽혀야 하며, 아무것도 거칠게 튀어 보이지 않아야 합니다.
  • 시그니처 테스트 — 시그니처가 드러나는 구체적인 요소 다섯 곳을 짚어 보십시오. 전체적인 느낌은 인정되지 않습니다.
  • 토큰 테스트 — CSS 변수를 소리 내어 읽고, 이것이 이 제품의 세계에 속하는지 아니면 아무 프로젝트에나 속하는지 물어봅니다.
  • 인라인 렌더 도구, 로컬 브라우저 또는 데스크톱과 모바일 너비의 스크린샷에서 결과를 확인합니다.
  • 무엇을 제시하기 전에 겹침, 깨진 간격, 빈 상태, 읽을 수 없는 텍스트, 누락된 에셋, 일반적인 구성을 먼저 수정합니다.

OpenDesign에서 SKILL.md 링크로 interface-design을 가져옵니다: Plugins → Add → Skill → Import from link, 그런 다음 상단 바에서 선택합니다.

05 오픈 소스, 추적 가능

출처, 라이선스 및 검증

이 페이지의 사실이 어디에서 왔으며 언제 마지막으로 확인되었는지 안내합니다.

스킬 파일
.claude/skills/interface-design/SKILL.md 검증 시 콘텐츠 체크섬 기록됨; 커밋 2f9be32
License
MIT LICENSE에서.
리포지토리 스타
5,692 전체 Dammyjay93/interface-design 저장소에 대해 2026-09-14에 촬영된 GitHub 스냅샷입니다. interface-design의 평가 또는 사용 횟수가 아닙니다.
OpenDesign에서 검증됨
2026-09-14 소스 파일, 경로, 라이선스 텍스트 및 스타 수가 확인되었습니다. OpenDesign 메인에 번들로 포함되지 않음(2026-08-28 확인); 이 페이지에 실제 실행 기록이 없습니다.

SKILL.md 내부

  1. 범위대시보드, 관리자 패널, SaaS 앱, 도구, 설정 페이지에 사용하고, 랜딩 페이지나 마케팅 작업에는 사용하지 않습니다.
  2. 의도 우선사용자가 누구인지, 무엇을 해내야 하는지, 어떤 느낌이어야 하는지를 답합니다.
  3. 제품 도메인 탐색먼저 도메인 개념, 색상 세계, 시그니처, 그리고 거부된 기본값 3가지를 도출합니다.
  4. 가능할 때 렌더링하기제안하거나 컴포넌트를 만들거나 비평할 때는 조건에 따라 시안을 렌더링하고, 추론은 서술문으로 유지합니다.
  5. Visual H
스킬 자체 설명
대시보드, 관리 패널, SaaS 앱, 도구, 설정 페이지, 데이터 인터페이스 및 인터랙티브 제품을 위한 크래프트 중심 인터페이스 디자인. 시각적 크래프트, 레이아웃 계층 구조, 토큰, 상태, 시각적 방향 또는 디자인 시스템 일관성이 중요한 제품 UI를 디자인, 구축, 검토, 감사 또는 개선할 때 사용합니다. 마케팅 페이지, 랜딩 페이지, 캠페인 또는 브랜드 전용 작업에는 적합하지 않습니다.

SKILL.md의 머리말 설명입니다. 전체 파일은 약 29,304자입니다. GitHub에서 전체 파일 읽기.

Interface Design

실제 UI 디자인 작업에서 interface-design 실행

OpenDesign을 다운로드하고 SKILL.md 링크에서 interface-design을 가져온 후, 위 프롬프트를 붙여넣고 결과 전에 계획을 읽으십시오.

터미널
npx skills add https://github.com/Dammyjay93/interface-design --skill interface-design

OpenDesign 데스크톱

하나의 디자인 시스템으로 모든 결과물에 브랜드 일관성을

완전한 Vibe Design Workspace에서 하나의 브랜드 규칙을 웹사이트, 슬라이드, 인터랙티브 프로토타입, 대시보드, 이미지, HTML 영상에 적용하세요. 로컬 Codex, Claude Code, Cursor 등을 연결해 무료로 제작할 수 있습니다.

  • 웹, 슬라이드, 프로토타입, 대시보드, 이미지, 영상
  • 140개+ 디자인 시스템과 전체 템플릿·스킬 라이브러리
  • 로컬 Codex 및 21개+ 코딩 에이전트 연결 · 무료
무료 다운로드

macOS, Windows 지원