angular-material-developer skill
✓ 検証済みMaterial 3テーマシステムとCDKプリミティブを使用した、Angularプロジェクト向けのAngular Materialコードおよび実装ガイドを生成します。
- GitHubスター
- 33
- ファイル
- 13
- 最終コミット
- 2026年10月21日
- ライセンス
- MIT
- 許可されたツール
- —
angular-material-developer skillは何をしますか
Material 3テーマシステムとCDKプリミティブを使用した、Angularプロジェクト向けのAngular Materialコードおよび実装ガイドを生成します。
skillのSKILL.mdから生成された要約。
angular-material-developer skill について
Angularでユーザーインターフェースを構築する開発者は、このSKILLを使用して、Angular Materialプロジェクト向けの正確なコードと実装ガイドを生成できます。このSKILLはMaterial 3テーマシステムに特化しており、mat.theme()のようなSassミックスインや、デザイントークン、密度、タイポグラフィを管理するためのプリビルトパレットを活用します。Angular v19以降を実行しているプロジェクト向けに設計されており、スタンドアロンコンポーネント、SignalベースのAPI、新しい制御フロー構文などのモダンなパターンに焦点を当てています。
エージェントがpackage.json内の@angular/materialを検出した場合、またはmat-*コンポーネントに関するリクエストを受けた場合、フォームコントロール、ナビゲーション、オーバーレイ、データテーブルの実装詳細を提供します。また、Overlay、Drag-Drop、Virtual Scrollを含む、スタイルの適用されていない@angular/cdkプリミティブのサポートも行います。Material 2からMaterial 3への移行や、バージョン22におけるアニメーションのピア依存関係の削除など、バージョン固有の複雑な変更への対応も可能です。ReactiveFormsや新しいSignal Formsと統合可能な、本番環境で使用できるコードを生成します。
エージェントができること
- 1Material 3テーマの実装特定のカラーパレットと密度設定を使用して、Material 3テーマをセットアップするためのSassコードを生成します。
- 2レガシーなMaterialプロジェクトの移行古いAngularプロジェクトをMaterial 2からMaterial 3へ移行するためのガイドラインとコードパターンを取得します。
- 3Signal Formsとinputの統合最新のAngular SignalベースのフォームAPIに対応したフォームフィールドコンポーネントを作成します。
- 4ヘッドレスCDKプリミティブの活用Materialのデフォルトスタイルを使用せずに、ドラッグ&ドロップや仮想スクロールなどの高度な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プロバイダーが必要ですか?
いいえ、バージョン21.2以降および22では、Materialは@angular/animationsをピア依存関係として必要とせず、ネイティブCSSを通じてアニメーションを実行します。
SassなしでAngular Materialを使用できますか?
いいえ、CSSのみのスタンドアロンなテーマ設定はサポートされていないため、テーマエンジンにはSassが必要です。
最新のAngularプロジェクトでは、Materialコンポーネントをどのようにインポートすべきですか?
従来のモジュールを使用するのではなく、常に特定のインポートパスからスタンドアロンコンポーネントのクラスを直接インポートしてください。