Skill angular-material-developer
✓ VerificadoGenera código de Angular Material y guías para proyectos de Angular utilizando el sistema de tematización Material 3 y las primitivas de CDK.
- Estrellas en GitHub
- 33
- Archivos
- 13
- Último commit
- 21 oct 2026
- Licencia
- MIT
- Herramientas permitidas
- —
¿Qué hace la skill angular-material-developer?
Genera código de Angular Material y guías para proyectos de Angular utilizando el sistema de tematización Material 3 y las primitivas de CDK.
Resumen generado a partir del SKILL.md de la skill.
Sobre la skill angular-material-developer
Los desarrolladores que construyen interfaces de usuario con Angular pueden usar este SKILL para generar código preciso y guías de implementación para proyectos de Angular Material. Se especializa en el sistema de tematización Material 3, utilizando mixins de Sass como mat.theme() y paletas predefinidas para gestionar design tokens, densidad y tipografía. El SKILL está diseñado para proyectos que ejecutan Angular v19 o superior, centrándose en patrones modernos como componentes standalone, APIs basadas en signals y la nueva sintaxis de control flow.
Cuando un agente detecta @angular/material en un package.json o recibe peticiones sobre componentes mat-*, proporciona detalles de implementación para controles de formulario, navegación, overlays y tablas de datos. También ayuda con las primitivas sin estilos de @angular/cdk, incluyendo Overlay, Drag-Drop y Virtual Scroll. Los usuarios pueden confiar en él para navegar por cambios complejos específicos de cada versión, como la transición de Material 2 a Material 3 o la eliminación de las peer dependencies de animación en la versión 22. Produce código listo para producción que se integra con ReactiveForms o los nuevos Signal Forms.
Lo que un agente puede hacer con ella
- 1Implementar tematización Material 3Generar código Sass para configurar un tema de Material 3 utilizando paletas de colores y ajustes de densidad específicos.
- 2Migrar proyectos de Material heredadosObtener guías y patrones de código para migrar un proyecto de Angular antiguo de Material 2 a Material 3.
- 3Integrar Signal Forms con inputsCrear componentes de campos de formulario que funcionen con las últimas APIs de formularios de Angular basadas en signals.
- 4Utilizar primitivas de CDK headlessImplementar comportamientos de UI avanzados como drag-and-drop o virtual scrolling sin utilizar los estilos predeterminados de Material.
Escrito a partir del SKILL.md de la skill. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar la skill angular-material-developer
Cada comando copia la carpeta de la skill al directorio de skills del cliente. Reinicia el cliente o inicia una nueva sesión para cargarla.Instalar la skill angular-material-developer en Claude Code
~/.claude/skills/angular-material-developer/SKILL.md
$ npx degit mofirojean/angular-ui-skills/skills/angular-material-developer ~/.claude/skills/angular-material-developerInstalar la skill angular-material-developer en Claude Code (project)
.claude/skills/angular-material-developer/SKILL.md
$ npx degit mofirojean/angular-ui-skills/skills/angular-material-developer .claude/skills/angular-material-developerInstalar la skill angular-material-developer en Codex
~/.agents/skills/angular-material-developer/SKILL.md
$ npx degit mofirojean/angular-ui-skills/skills/angular-material-developer ~/.agents/skills/angular-material-developerInstalar la skill angular-material-developer en Gemini CLI
~/.gemini/skills/angular-material-developer/SKILL.md
$ npx degit mofirojean/angular-ui-skills/skills/angular-material-developer ~/.gemini/skills/angular-material-developerInstalar la skill angular-material-developer en 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
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Superó nuestras comprobaciones automáticas. No es una auditoría de seguridad: lee los scripts antes de dejar que un agente los ejecute. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesiblemofirojean/angular-ui-skills/skills/angular-material-developer is public and reachablegithub.com/mofirojean/angular-ui-skills/tree/HEAD/skills/ang ↗Aprobado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit 2026-10-21github.com/mofirojean/angular-ui-skills/commits ↗Aprobado
- Sin descargar y ejecutar ni robo de credenciales en los scriptsNo scripts in the skill folderAprobado
- Sin instrucciones ocultas en SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/mofirojean/angular-ui-skills/blob/HEAD/skills/ang ↗Aprobado
- Las herramientas preaprobadas están acotadasNo pre-approved tools; the agent asks before using onegithub.com/mofirojean/angular-ui-skills/blob/HEAD/skills/ang ↗Aprobado
- SKILL.md sigue el formato de Agent SkillsValid name and description; says when to use it; 103 linesgithub.com/mofirojean/angular-ui-skills/blob/HEAD/skills/ang ↗Aprobado
SKILL.md
Ver en 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
Archivos de esta skill
13Preguntas sobre la skill angular-material-developer
¿Cómo instalo la skill angular-material-developer en Claude Code?
Ejecuta npx degit mofirojean/angular-ui-skills/skills/angular-material-developer ~/.claude/skills/angular-material-developer. Claude Code carga las skills desde ~/.claude/skills (todos los proyectos) o .claude/skills (un proyecto) y usa una skill cuando su descripción coincide con la tarea.
¿Qué clientes pueden usar la skill angular-material-developer?
Cualquier cliente que lea el formato Agent Skills: Claude Code, Codex, Gemini CLI y claude.ai (subir como ZIP). Los scripts de la skill se ejecutan solo donde el cliente permite la ejecución de código.
¿Requiere Angular Material un proveedor de animaciones en la versión 22?
No, en las versiones 21.2+ y 22, Material ya no requiere @angular/animations como peer dependency y realiza las animaciones mediante CSS nativo.
¿Puedo usar Angular Material sin Sass?
No, Sass es necesario para el motor de tematización, ya que no se admite la tematización únicamente con CSS independiente.
¿Cómo debo importar los componentes de Material en proyectos modernos de Angular?
Siempre debes importar la clase del componente standalone directamente desde su ruta de importación específica en lugar de utilizar módulos heredados.