angular-material-developer skill
✓ 인증됨Material 3 테마 시스템과 CDK primitives를 사용하여 Angular 프로젝트를 위한 Angular Material 코드 및 가이드를 생성합니다.
- GitHub 스타
- 33
- 파일
- 13
- 마지막 커밋
- 2026년 10월 21일
- 라이선스
- MIT
- 허용된 도구
- —
angular-material-developer skill은 무엇을 하나요?
Material 3 테마 시스템과 CDK primitives를 사용하여 Angular 프로젝트를 위한 Angular Material 코드 및 가이드를 생성합니다.
skill의 SKILL.md에서 생성된 요약입니다.
angular-material-developer skill 정보
Angular로 사용자 인터페이스를 구축하는 개발자는 이 SKILL을 사용하여 Angular Material 프로젝트를 위한 정밀한 코드와 구현 가이드를 생성할 수 있습니다. 이 SKILL은 Material 3 테마 시스템에 특화되어 있으며, mat.theme()와 같은 Sass mixin 및 prebuilt palettes를 활용하여 디자인 토큰, 밀도(density), 타이포그래피를 관리합니다. Angular v19 이상 버전의 프로젝트를 대상으로 설계되었으며, standalone components, signal-based APIs, 새로운 control flow syntax와 같은 최신 패턴에 집중합니다.
에이전트가 package.json에서 @angular/material을 감지하거나 mat-* 컴포넌트에 관한 요청을 받으면, form controls, navigation, overlays, data tables에 대한 구현 세부 정보를 제공합니다. 또한 Overlay, Drag-Drop, Virtual Scroll을 포함한 스타일이 지정되지 않은 @angular/cdk primitives 활용도 지원합니다. 사용자는 Material 2에서 Material 3로의 전환이나 22 버전에서의 animation peer dependency 제거와 같은 복잡한 버전별 변경 사항을 파악하는 데 이 SKILL을 활용할 수 있습니다. ReactiveForms 또는 최신 Signal Forms와 통합되는 프로덕션 수준의 코드를 생성합니다.
agent가 수행할 수 있는 작업
- 1Material 3 테마 구현특정 컬러 팔레트와 밀도 설정을 사용하여 Material 3 테마를 구축하기 위한 Sass 코드를 생성합니다.
- 2레거시 Material 프로젝트 마이그레이션기존 Angular 프로젝트를 Material 2에서 Material 3로 전환하기 위한 가이드와 코드 패턴을 제공합니다.
- 3Signal Forms와 input 통합최신 Angular signal-based form API와 연동되는 form field 컴포넌트를 생성합니다.
- 4Headless CDK primitives 활용Material의 기본 스타일을 사용하지 않고 drag-and-drop 또는 virtual scrolling과 같은 고급 UI 동작을 구현합니다.
skill의 SKILL.md를 기반으로 작성되었습니다. 모든 사용 사례는 해당 문서의 인용구와 대조 확인되었습니다.
angular-material-developer skill 설치 방법
각 명령은 skill 폴더를 클라이언트의 skills 디렉터리에 복사합니다. 클라이언트를 재시작하거나 새 세션을 시작하여 로드하세요.Claude Code에 angular-material-developer skill 설치
~/.claude/skills/angular-material-developer/SKILL.md
$ npx degit mofirojean/angular-ui-skills/skills/angular-material-developer ~/.claude/skills/angular-material-developerClaude Code (project)에 angular-material-developer skill 설치
.claude/skills/angular-material-developer/SKILL.md
$ npx degit mofirojean/angular-ui-skills/skills/angular-material-developer .claude/skills/angular-material-developerCodex에 angular-material-developer skill 설치
~/.agents/skills/angular-material-developer/SKILL.md
$ npx degit mofirojean/angular-ui-skills/skills/angular-material-developer ~/.agents/skills/angular-material-developerGemini CLI에 angular-material-developer skill 설치
~/.gemini/skills/angular-material-developer/SKILL.md
$ npx degit mofirojean/angular-ui-skills/skills/angular-material-developer ~/.gemini/skills/angular-material-developerClaude.ai에 angular-material-developer skill 설치
npx degit mofirojean/angular-ui-skills/skills/angular-material-developer angular-material-developer && zip -r angular-material-developer.zip angular-material-developer # claude.ai → Customize → Skills → + → Create skill → Upload a skill → angular-material-developer.zip
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 보안 감사는 아닙니다. 에이전트가 실행하기 전에 스크립트를 읽어 보세요. 검사 방식
- 소스 저장소 연결 및 접근 가능mofirojean/angular-ui-skills/skills/angular-material-developer is public and reachablegithub.com/mofirojean/angular-ui-skills/tree/HEAD/skills/ang ↗통과
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit 2026-10-21github.com/mofirojean/angular-ui-skills/commits ↗통과
- 스크립트에 다운로드 후 실행이나 자격 증명 탈취가 없음No scripts in the skill folder통과
- SKILL.md에 숨겨진 지침 없음No override phrases, safeguard switches, credential requests or hidden charactersgithub.com/mofirojean/angular-ui-skills/blob/HEAD/skills/ang ↗통과
- 사전 허용 도구가 제한됨No pre-approved tools; the agent asks before using onegithub.com/mofirojean/angular-ui-skills/blob/HEAD/skills/ang ↗통과
- SKILL.md가 Agent Skills 형식을 따름Valid name and description; says when to use it; 103 linesgithub.com/mofirojean/angular-ui-skills/blob/HEAD/skills/ang ↗통과
SKILL.md
GitHub에서 보기Angular Material Developer Guidelines
Pairs with
angular-developer, that skill provides Angular fundamentals (signals, DI, routing, forms, SSR, accessibility). This skill focuses on Angular Material specifics. Install both for the best experience.
Compatibility
- Tracks:
@angular/material@22.2.4(Angular v22), paired with@angular/cdk@22.2.4(Material peers an exact cdk version, keep the two pinned together). The v21-aligned line remains at21.2.xfor legacy projects. - Animations peer dropped (v21.2+): Material no longer declares an
@angular/animationspeer dependency and animates via native CSS.ng add @angular/materialon 21.2+/22 does not wireprovideAnimationsAsync()and does not require@angular/animations, do not add either to a fresh Material 22 app. (Earlier v21.x and all v18-20 apps still need the provider; see setup.md.) - Works for: Material v19 → v22 projects (M3 theming system landed in v19; older majors used M2 with the now-legacy
mat.define-light-theme/mat.define-dark-themeAPI). - Angular: v19 or newer required. v22 requires Node 22 or 26 and TypeScript 6. The skill assumes standalone components, control flow (
@if/@for), and signal-based APIs. - Sass: required for theming. The build pipeline must support
.scss(Angular CLI does by default). Standalone CSS-only theming is not supported by Material's theming engine. - Not supported: Material v18 and below (M2-only with
mat.define-*-theme()API), Angular v18 or below (NgModule patterns + older animations API).
v22.2 highlights (from 22.1)
Additive minor, no breaking changes. Peers are unchanged (@angular/core, forms, common, platform-browser ^22.0.0 || ^23.0.0).
MatIconauto Material Symbols class (22.2.0): when only the Material Symbols font is loaded,<mat-icon>adds thematerial-symbols-*class itself, sosetDefaultFontSetClass(...)is no longer needed for the single-font case. If both legacy Material Icons and Symbols are loaded, the old behaviour applies.MatMenuItemdisabledInteractive(22.2.0): disabled styling that stays focusable and hoverable, so a tooltip can explain why the item is disabled.MatFormFieldControlsupports Signal Forms (22.2.0) and the datepicker reports parse errors under Signal Forms (22.2.4).- CDK overlay
disposeOnNavigation: 'url-change'(22.2.1): opt in to closing on any URL change, not just back/forward. - Patch fixes worth knowing: CDK a11y treats
inertelements as non-focusable (22.2.3), chips get a touch target (22.2.3),mat-iconno longer copies event attributes (22.2.2).
v22 breaking changes (from v21)
The v21 → v22 jump has real API drift, not just an Angular version bump. Watch for:
- Combobox: legacy combobox and autocomplete promoted / removed.
SimpleComboboxpromoted toComboboxwith allsimpleCombobox*symbols renamed tocombobox*. - List:
MatListOption.checkboxPositionremoved, usetogglePositioninstead.MatListOptionCheckboxPositionrenamed toMatListOptionTogglePosition. - CDK:
injectorparameter is now required onConfigurableFocusTrapandFocusTrapconstructors.ConfigurableFocusTrapFactory.createboolean parameter replaced with a config object.DropListRef.dropevent parameter is now required.ContextMenuTrackerrenamed toMenuTracker. Removed:CDK_DESCRIBEDBY_HOST_ATTRIBUTE,CDK_DESCRIBEDBY_ID_PREFIX,MESSAGES_CONTAINER_ID. - Multiple components: input/model rename from
valuestovalueacross Combobox, Listbox, Tree, Menu, Toolbar, Select. Constructors with rest arguments removed (affects code that extends Material or CDK components). - Dialog / Overlay:
ArrowViewStateandArrowViewStateTransitiontypes removed.
Most of these have automatic ng update migrations. When in doubt, run ng update @angular/material and let the schematic do the work before hand-editing.
v22 new features worth knowing
- Signal Forms stable (was experimental in v21). Angular's signal-based form API is now safe to use in production.
mat-form-fieldcomposes with bothReactiveFormsModuleand Signal Forms. - Angular Aria stable (was preview). New accessibility primitives ship in the framework, which reduces the need to reach for CDK's a11y module for some patterns.
- Button progress indicator support inside
<button>component. - Portal directives support on
ComponentPortal. - Separate tab animation durations (per-tab enter/exit timing).
-
Check the project's Material version before answering. Material's M3 theming engine was introduced in v19 (
mat.theme()mixin replacingmat.define-light-themeandmat.define-dark-theme). Code generated against M3 will silently break on M2 projects.package.jsonis the source of truth. -
Detect the theming generation in
styles.scss:- If you see
@include mat.theme((...))→ M3 (v19+, default). Usemat.theme(), Material's prebuilt palettes, and CSS variable overrides. - If you see
mat.define-light-theme(...)ormat.define-dark-theme(...)plus@include mat.all-component-themes($theme)→ M2 (legacy). Recommend migrating, see migration.md. - The two systems compile and behave very differently. See theming.md.
- If you see
-
Components are standalone since v15. Always import the standalone class (e.g.
MatButtonfrom'@angular/material/button'), not the legacyMatButtonModule. The modules still re-export everything for backwards compatibility but should not be added to new code. -
After generating Material code, run
ng build. The most common AI mistakes are: (a) using v17-eramat.define-light-themesyntax in a v19+ project (compiles but silently emits no CSS vars); (b) on v18-v21.1, forgettingprovideAnimationsAsync(), which makes ripples, menu open/close, and dialog backdrop animations no-op (on 21.2+/22 do not add it, Material animates via native CSS); (c) missing@angular/cdkpeer dep, Material imports cascade through it; (d) usingMatTablewithout aMatSort/MatPaginatorwiring up, the column header sort UI appears but does nothing.
Material architecture: components, CDK, theming
Angular Material ships three layers:
- Components (
@angular/material/*) , the styledmat-*components themselves:MatButton,MatFormField,MatTable,MatDialog, etc. Each lives at its own import path. - CDK (
@angular/cdk/*) , unstyled primitives Material composes on top of:Overlay,Portal,A11y(FocusTrap, LiveAnnouncer, ListKeyManager),DragDrop,VirtualScroll,Stepper. Always installed as a peer dep alongside Material. Useful on its own when you need a primitive but don't want Material's styling. See cdk.md. - Theming engine (
@angular/material/_index.scss) , the Sass mixins (mat.theme(),mat.theme-overrides()) that emit CSS variables consumed by every component. Sass is required, no CSS-only theming path.
Default to importing from @angular/material/<component> (e.g. MatButton from '@angular/material/button'). Reach for @angular/cdk/<primitive> only when you need the headless primitive or are building a custom-styled component composing Material's behaviour.
Installation and theming
- Setup:
ng add @angular/material(handles the install + writes a default theme; on v18-v21.1 it also wiresprovideAnimationsAsync(), on 21.2+/22 it does not, Material animates via native CSS), or manual install. Read setup.md - Theming (M3):
mat.theme()mixin, prebuilt palettes (mat.$violet-palette,mat.$azure-palette, etc.), density and typography knobs,light darkcolor-scheme, per-component overrides viamat.<component>-overrides(). Read theming.md - M2 → M3 migration: the v19 ng-update schematic + manual fix patterns. Read migration.md
Components
Angular Material documents 40+ components grouped by category. Each category file below covers the components, their key inputs, common patterns, and gotchas.
- Form Controls: Autocomplete, Checkbox, Datepicker, FormField, Input, Radio, Select, Slider, SlideToggle. Read form-controls.md
- Buttons & Indicators: Button, ButtonToggle, Badge, Chip, Icon, ProgressBar, ProgressSpinner, Ripple. Read buttons-indicators.md
- Layout: Card, Divider, ExpansionPanel, GridList, List, Stepper, Tabs, Tree. Read layout.md
- Navigation: Menu, Sidenav, Toolbar. Read navigation.md
- Popups & Modals: BottomSheet, Dialog, Snackbar, Tooltip. Read overlays.md
- Data Table: Table, Paginator, Sort, MatTableDataSource. Read data-table.md
CDK primitives
- CDK: Overlay, Portal, A11y (FocusTrap, FocusMonitor, LiveAnnouncer, ListKeyManager), Drag-Drop, VirtualScroll, Stepper, ScrollDispatcher, Layout (
Breakpoints). Read cdk.md
Forms integration
- Forms: Wiring Material components to ReactiveForms (the canonical path) and Signal Forms (Angular v22+) via
mat-form-field,MatInput/MatSelect/MatDatepicker,ErrorStateMatcherpatterns,<mat-error>display, andControlValueAccessorfor custom controls. Read forms.md
Accessibility
- Accessibility: Material's WCAG 2.1 AA targets, FocusMonitor for keyboard-vs-mouse focus styling, LiveAnnouncer for transient announcements, RTL support, the things Material gives you free and the things you still need to do. Read accessibility.md
이 스킬의 파일
13angular-material-developer skill 질문
Claude Code에 angular-material-developer skill을 어떻게 설치하나요?
npx degit mofirojean/angular-ui-skills/skills/angular-material-developer ~/.claude/skills/angular-material-developer를 실행합니다. Claude Code는 ~/.claude/skills(모든 프로젝트) 또는 .claude/skills(한 프로젝트)에서 skills를 로드하며, 설명이 작업과 일치할 때 skill을 사용합니다.
angular-material-developer skill을 사용할 수 있는 클라이언트는 무엇인가요?
Agent Skills 형식을 읽는 모든 클라이언트(Claude Code, Codex, Gemini CLI, claude.ai(ZIP으로 업로드))가 사용할 수 있습니다. skill 내 스크립트는 클라이언트가 코드 실행을 허용하는 경우에만 실행됩니다.
Angular 22 버전에서 Angular Material 사용 시 animations provider가 필요한가요?
아니요, 21.2 버전 이상 및 22 버전부터 Material은 @angular/animations를 peer dependency로 요구하지 않으며, 네이티브 CSS를 통해 애니메이션을 구현합니다.
Sass 없이 Angular Material을 사용할 수 있나요?
아니요, standalone CSS 전용 테마는 지원되지 않으므로 테마 엔진을 위한 Sass가 반드시 필요합니다.
최신 Angular 프로젝트에서 Material 컴포넌트를 어떻게 import해야 하나요?
레거시 모듈을 사용하는 대신, 항상 해당 컴포넌트의 특정 import 경로에서 standalone component class를 직접 import해야 합니다.