사용 가이드로 건너뛰기
material-3작성자 hamen

Material 3 스킬.

모바일 앱 디자인을 위한 Claude Code 및 Codex skill: Material Design 3 토큰, 컴포넌트 및 적응형 레이아웃을 구현합니다.

  • 모바일 앱
  • UI 코드
hamen/material-3-skill · skills/material-3/SKILL.mdSKILL.md
--- name: material-3 description: Implement Google's Material Design 3 (Material You) UI system. Primary: Jetpack Compose Material3 (MaterialTheme, components, adaptive layout). Also Flutter and limited web (@material/web, maintenance mode). Covers tokens, 30+ components, layout, theming, M3 Expressive (platform matrix), and accessibility. Use when: "material design", "MD3", "material you", "Jetpack Compose", "MaterialTheme", "material component", … --- ## Philosophy ## Current Updates: Google I/O 2026 ## Decision Tree ## Design Token System ## Jetpack Compose (primary) ## Web (limited): @material/web
업스트림 파일에서 읽은 전문 및 섹션 제목 2026-09-14 · 전체 31,218자

01 기능

Claude Code와 Codex에서 material-3 Skill이 하는 일

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

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

스킬 자체의 표현으로

Jetpack Compose Material3을 주요 대상으로 하여 Google의 Material Design 3(Material You) 구현을 안내하며, Flutter와 @material/web을 통한 제한적인 웹 경로도 다룹니다. 색상, 타입스케일, 모양, 고도, 모션을 위한 md.sys 토큰 시스템, 30개 이상의 컴포넌트와 그 변형에 대한 빠른 참조, 적응형 레이아웃과 내비게이션, 테마 설정과 다이나믹 컬러, M3 Expressive 플랫폼 매트릭스, 그리고 접근성을 다룹니다.

감사 모드는 앱이나 페이지를 열 가지 범주에 걸쳐 0-10점으로 채점하고 준수 리포트를 생성합니다. 다섯 가지 윈도우 크기 클래스, 그림자 대신 tonal elevation, 8dp 간격 시스템, 대형 윈도우에서의 최대 콘텐츠 너비 등 구체적인 MD3 기본값이 필요한 디자이너와 개발자를 위한 것입니다.

산출물

  • 전체 점수와 범주별 점수, 심각한 문제, 경고, 통과 항목, 우선순위가 매겨진 수정 사항을 포함한 markdown MD3 준수 리포트입니다.
  • dynamicLightColorScheme, lightColorScheme 또는 생성된 테마 코드로 제공되는 colorScheme을 사용하여 MaterialTheme으로 구성된 Compose 테마입니다.
  • 미디어 쿼리나 클래스로 적용되는 다크 테마 변형을 포함한 md-sys 커스텀 속성으로 구성된 CSS 테마 블록입니다.
예시 프롬프트 보기 ↗

작동 방식

  1. 01
    스택에서 다르게 지시하지 않는 한 Compose에서 시작합니다

    이 파일은 Jetpack Compose Material3을 기본 경로로 취급하며, Decision Tree는 코드를 작성하기 전에 앱 셸, 단일 컴포넌트, 테마, 폼, 내비게이션, 데이터 표시를 특정 섹션과 참조 파일로 안내합니다.

  2. 02
    토큰 레이어 적용

    모든 MD3 토큰은 md.sys 네임스페이스에 있습니다. Compose는 동일한 시맨틱 역할을 MaterialTheme.colorScheme, typography, shapes에 매핑하며, 웹에서는 md-sys 접두사가 붙은 CSS custom properties에 매핑합니다.

  3. 03
    Quick Reference에서 Components 선택하기

    컴포넌트 표는 각 컴포넌트의 웹 요소 이름, 주요 variant, 카테고리를 나열하고, @material/web 구현이 없는 항목을 표시하여 표준 HTML과 CSS custom properties로 대신 구현할 수 있도록 합니다.

  4. 04
    Common Patterns로 조립하기

    App Shell, Card Grid, Form Layout 패턴이 HTML과 CSS로 제공되며, 좁은 폭에서 navigation rail을 bottom navigation으로 전환하는 breakpoint도 포함됩니다.

  5. 05
    요청 시 감사(Audit) 수행

    audit로 호출되면, 이 skill은 URL, 소스 파일 또는 실행 중인 앱을 검사하고 보고서를 작성하기 전에 열 개 카테고리를 0에서 10점으로 채점합니다.

02 적합성 확인

material-3 스킬을 사용해야 하는 경우

이러한 종류의 모바일 앱 디자인 작업일 때 Claude Code 또는 Codex에서 material-3 스킬을 사용하십시오. 적합성과 한계는 스킬 자체 파일에서 가져왔습니다.

적합한 경우

  • Scaffold, Button, NavigationBar와 같은 androidx.compose.material3 컴포저블을 사용하여 Jetpack Compose에서 새로운 Android 화면이나 앱을 만드는 경우.
  • Android 12 이상에서 사용자의 배경화면으로부터 dynamic color를 사용해 테마를 생성하고, 그렇지 않은 경우 정적인 light/dark 스킴으로 대체하는 경우.
  • 고정된 phone-first 디자인이 아니라, 휴대폰, 폴더블, 데스크톱, 워치, XR에 걸쳐 적응하는 하나의 레이아웃.
  • 기존 앱이나 페이지를 MD3에 대해 감사하고 이를 바탕으로 작업할 수 있는 점수화된 보고서를 얻는 경우.
  • 루트나 다른 상위 요소에 MD3 CSS custom properties를 설정하여 웹 UI를 테마화하는 경우.

한계 인지하기

  • Material Web은 유지보수 전용이고 Expressive는 구현되어 있지 않으므로, 웹에서 M3 Expressive 기능을 기대하는 경우.
  • 웹 컴포넌트가 JavaScript가 필요한 custom elements이므로, hydration 전략 없이 서버 사이드 렌더링을 수행하는 경우.
  • API와 스타일링이 호환되지 않는 Material 2와 Material 3 라이브러리를 여전히 혼용하는 프로젝트.
  • 대형 화면과 폴더블을 무시하는 phone-only 레이아웃, 힌지에 걸쳐 배치된 인터랙티브 콘텐츠를 포함.

제공할 사항

  • 작업 인자(task argument)이 skill은 component, theme, layout, scaffold 또는 audit 인자를 받으며, 그 뒤에 짧은 설명이나 URL이 따라와 어떤 섹션이나 참조 파일을 따를지 결정합니다.
  • 감사할 대상audit 작업의 경우, 브라우저 검사를 위한 URL, 소스를 읽기 위한 파일 경로, 또는 실행 중인 앱에 대한 접근을 제공합니다.
  • 커스텀 테마를 위한 seed color하나의 seed color만으로도 전체 색상 스킴을 도출할 수 있으며, 이 파일은 값을 생성하기 위한 material-color-utilities 패키지를 안내합니다.
  • 코드 감사를 위한 소스 파일Compose 감사는 Kotlin 파일을 읽어 MaterialTheme 사용, 컴포저블, 원시 Color 값, 하드코딩된 Dp, 누락된 semantics를 찾습니다.

03 스킬 내부

material-3 Skill이 Claude Code와 Codex에 부여하는 규칙

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

  1. 새로운 Material 작업은 Compose 우선

    새로운 Android 작업의 경우 이 파일은 컴포넌트, expressive API, adaptive scaffold, Styles API 통합에 Jetpack Compose Material3를 우선하도록 안내하며, Android Views는 기존 앱에서만 허용됩니다.

  2. 색상 하드코딩 금지

    하드코딩된 색상은 다이내믹 테마, 다크 모드, 명암 대비 조정을 깨뜨리므로, 원시 hex 또는 rgb 값 대신 md-sys-color 토큰을 사용합니다.

  3. 의도된 톤 페어 유지

    예를 들어 primary와 on-primary, surface-container와 on-surface처럼 설계된 대로만 색상을 조합합니다. 임의의 조합은 다이내믹 컬러 및 고대비 모드에서 명암 대비를 깨뜨립니다.

  4. 구분선에는 outline-variant 사용

    구분선은 outline-variant로 그려지며, outline은 텍스트 필드 테두리 같은 중요한 경계선용으로 예약되어 있습니다.

  5. 웹 컴포넌트는 개별적으로 임포트

    @material/web 패키지를 배럴 임포트하지 말고 사용 중인 컴포넌트 모듈만 임포트합니다. 전체를 임포트하면 번들 크기가 크게 늘어납니다.

  6. 대형 창에서는 너비 제한

    Large(1200dp 이상) 및 Extra-large(1600dp 이상) 창에서는 콘텐츠가 최대 840-1040dp 너비로 제한됩니다. 끝없이 넓은 텍스트 줄은 읽기 어렵기 때문입니다.

  7. 엘리베이션은 톤이며 그림자가 아님

    MD3는 그림자가 아니라 톤 서피스 색상으로 엘리베이션을 표현합니다. 그림자는 요소가 복잡한 배경으로부터 추가적인 분리가 필요할 때만 더해집니다.

  8. MD3에서는 Roboto가 올바른 선택

    Roboto 또는 Roboto Flex는 기본 Material 서체이며, Roboto를 피하라는 frontend-design 조언은 여기에 적용되지 않습니다. 의도적으로 타입 스케일을 커스터마이즈할 때만 교체합니다.

04 활용하기

Claude Code 또는 Codex에 material-3 설치

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

Claude Code, Codex 또는 사용 중인 에이전트에 material-3 추가

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

Terminal
npx skills add https://github.com/hamen/material-3-skill --skill material-3

skills/material-3/SKILL.md에 대한 일반적인 skills CLI 형식입니다. 저장소가 자체 경로를 문서화하고 있을 수 있습니다.

스킬에 첫 모바일 앱 디자인 작업 부여

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

Starter prompt
We're moving our [Android app] from Material 2 to MD3. Set up MaterialTheme with dynamic color on Android 12+ and wire the md.sys color, type and shape tokens, then rebuild [screen name] as a Scaffold with a navigation rail on medium and expanded window size classes. We ship on foldables too, so keep interactive content off the hinge and constrain content width on large windows.

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

첫 번째 결과 확인

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

  • MD3 역할 사용 여부만이 아니라 명암 대비 비율과 터치 타겟도 확인합니다.
  • 웹 스타일시트에서 하드코딩된 hex 색상을 검색합니다.
  • Kotlin 소스에서 원시 Color 값을 검색합니다.
  • JavaScript와 TypeScript에서 남아 있는 Material 2 임포트를 검색합니다.
  • 뷰포트 크기를 조절하거나 반응형 모드를 사용해 각 브레이크포인트에서 레이아웃을 확인합니다.

OpenDesign에서 material-3의 SKILL.md 링크로 임포트합니다: Plugins → Add → Skill → Import from link, 그런 다음 상단 바에서 선택합니다.

05 오픈 소스, 추적 가능

출처, 라이선스 및 검증

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

Author
hamen
Repository
github.com/hamen/material-3-skill 브랜치 master
스킬 파일
skills/material-3/SKILL.md 검증 시 콘텐츠 체크섬 기록됨; 커밋 14385f2
License
MIT LICENSE에서 확인.
리포지토리 스타
1,384 전체 hamen/material-3-skill 저장소에 대해 2026-09-14에 촬영한 GitHub 스냅샷입니다. material-3에 대한 평가 또는 사용 횟수가 아닙니다.
OpenDesign에서 검증됨
2026-09-14 소스 파일, 경로, 라이선스 텍스트 및 스타 수가 확인되었습니다. OpenDesign 메인에 번들로 포함되지 않음(2026-08-28 확인); 이 페이지에 실제 실행 기록이 없습니다.

SKILL.md 내부

  1. 철학다이내믹 컬러, 창 크기 클래스, 스프링 모션을 정의하는 세 가지 원칙, personal, adaptive, expressive.
  2. 의사결정 트리무엇을 만들고 있는지, 어떤 플랫폼인지에 따라 섹션과 참조 파일로 안내합니다.
  3. 디자인 토큰 시스템md.sys 색상, 타입, 형태, 엘리베이션, 모션 토큰과 Compose 및 CSS 매핑.
  4. 컴포넌트 빠른 참조웹 요소, 주요 변형, 카테고리를 포함한 30개 이상의 컴포넌트 표.
  5. Jetpack Compose(주 사용)androidx.compose.material3 설정, MaterialTheme, 다이내믹 컬러, 적응형 UI 및 인셋.
  6. Web(제한적): @material/web유지 관리 모드의 웹 컴포넌트, 개별 임포트, CSS 사용자 지정 속성 테마 및 다크 테마.
  7. 공통 패턴HTML과 CSS로 작성된 앱 셸, 카드 그리드, 폼 레이아웃 스니펫.
  8. 안티패턴MD2 혼용을 포함한 강력 금지 사항
스킬 자체 설명
"Google의 Material Design 3(Material You) UI 시스템을 구현합니다. 주요: Jetpack Compose Material3(MaterialTheme, 컴포넌트, 적응형 레이아웃). Flutter 및 제한적인 웹(@material/web, 유지 관리 모드)도 지원합니다. 토큰, 30개 이상의 컴포넌트, 레이아웃, 테마 설정, M3 Expressive(플랫폼 매트릭스) 및 접근성을 다룹니다. 사용 시기: \"material design\", \"MD3\", \"material you\", \"Jetpack Compose\", \"MaterialTheme\", \"material component\", \"md3 button\"."

SKILL.md의 front-matter 설명입니다. 전체 파일은 약 31,218자입니다. GitHub에서 전체 파일 읽기.

Material 3

실제 모바일 앱 디자인 작업에서 material-3 실행

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

터미널
npx skills add https://github.com/hamen/material-3-skill --skill material-3

OpenDesign 데스크톱

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

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

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

macOS, Windows 지원