angular-material-developer skill
✓ VerifiedGenerates Angular Material code and guidance for Angular projects using the Material 3 theming system and CDK primitives.
- GitHub stars
- 33
- Files
- 13
- Last commit
- Oct 21, 2026
- License
- MIT
- Allowed tools
- —
What does the angular-material-developer skill do?
angular-material-developer generates Angular Material code and guidance for Angular projects using the Material 3 theming system and CDK primitives.
Summary generated from the skill's SKILL.md.
About the angular-material-developer skill
Developers building user interfaces with Angular can use this skill to generate precise code and implementation guidance for Angular Material projects. It specializes in the Material 3 theming system, utilizing Sass mixins like mat.theme() and prebuilt palettes to manage design tokens, density, and typography. The skill is designed for projects running Angular v19 or newer, focusing on modern patterns such as standalone components, signal-based APIs, and the new control flow syntax.
When an agent detects @angular/material in a package.json or receives requests regarding mat-* components, it provides implementation details for form controls, navigation, overlays, and data tables. It also assists with the unstyled @angular/cdk primitives, including Overlay, Drag-Drop, and Virtual Scroll. Users can rely on it to navigate complex version-specific changes, such as the transition from Material 2 to Material 3 or the removal of animation peer dependencies in version 22. It produces production-ready code that integrates with ReactiveForms or the newer Signal Forms.
What an agent can do with it
- 1Implement Material 3 themingGenerate Sass code to set up a Material 3 theme using specific color palettes and density settings.
- 2Migrate legacy Material projectsGet guidance and code patterns for moving an older Angular project from Material 2 to Material 3.
- 3Integrate Signal Forms with inputsCreate form field components that work with the latest Angular signal-based form APIs.
- 4Utilize headless CDK primitivesImplement advanced UI behaviors like drag-and-drop or virtual scrolling without using Material's default styles.
Written from the skill's SKILL.md. Every use case is checked against a quote from it.
How to install the angular-material-developer skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the angular-material-developer skill in Claude Code
~/.claude/skills/angular-material-developer/SKILL.md
$ npx degit mofirojean/angular-ui-skills/skills/angular-material-developer ~/.claude/skills/angular-material-developerInstall the angular-material-developer skill in Claude Code (project)
.claude/skills/angular-material-developer/SKILL.md
$ npx degit mofirojean/angular-ui-skills/skills/angular-material-developer .claude/skills/angular-material-developerInstall the angular-material-developer skill in Codex
~/.agents/skills/angular-material-developer/SKILL.md
$ npx degit mofirojean/angular-ui-skills/skills/angular-material-developer ~/.agents/skills/angular-material-developerInstall the angular-material-developer skill in Gemini CLI
~/.gemini/skills/angular-material-developer/SKILL.md
$ npx degit mofirojean/angular-ui-skills/skills/angular-material-developer ~/.gemini/skills/angular-material-developerInstall the angular-material-developer skill in Claude.ai
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
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the scripts before you let an agent run them. How checks work
- Source repository linked and reachablemofirojean/angular-ui-skills/skills/angular-material-developer is public and reachablegithub.com/mofirojean/angular-ui-skills/tree/HEAD/skills/ang ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit 2026-10-21github.com/mofirojean/angular-ui-skills/commits ↗Pass
- No download-and-run or credential theft in scriptsNo scripts in the skill folderPass
- No hidden instructions in SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/mofirojean/angular-ui-skills/blob/HEAD/skills/ang ↗Pass
- Pre-approved tools are scopedNo pre-approved tools; the agent asks before using onegithub.com/mofirojean/angular-ui-skills/blob/HEAD/skills/ang ↗Pass
- SKILL.md follows the Agent Skills formatValid name and description; says when to use it; 103 linesgithub.com/mofirojean/angular-ui-skills/blob/HEAD/skills/ang ↗Pass
SKILL.md
View on GitHubAngular 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
Files in this skill
13angular-material-developer skill questions
How do I install the angular-material-developer skill in Claude Code?
Run npx degit mofirojean/angular-ui-skills/skills/angular-material-developer ~/.claude/skills/angular-material-developer. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the angular-material-developer skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.
Does Angular Material require an animations provider in version 22?
No, in version 21.2+ and 22, Material no longer requires @angular/animations as a peer dependency and animates via native CSS.
Can I use Angular Material without Sass?
No, Sass is required for the theming engine as standalone CSS-only theming is not supported.
How should I import Material components in modern Angular projects?
You should always import the standalone component class directly from its specific import path rather than using legacy modules.