Skip to content

[material_ui] Add Material 3 Expressive migration skill - #12818

Merged
auto-submit[bot] merged 1 commit into
flutter:mainfrom
QuncCccccc:material-3-expressive-migration-skill
Oct 2, 2026
Merged

auto-submit[bot] merged 1 commit into
flutter:mainfrom
QuncCccccc:material-3-expressive-migration-skill

Conversation

@QuncCccccc

@QuncCccccc QuncCccccc commented Sep 9, 2026 •

Copy link
Copy Markdown
Contributor

This PR is to add an agent skill for Material 3 Expressive component migration work in packages/material_ui.

Related to Bring Material 3 Expressive to Flutter. Will wait until flutter/flutter#192519 lands.

Once this PR is landed, use prompts like

  • /material-3-expressive-migration Migrate <component name> in packages/material_ui.
  • Use the material-3-expressive-migration skill to migrate <component name> in packages/material_ui.

to invoke the skill.

Pre-Review Checklist

  • I read the [Contributor Guide] and followed the process outlined there for submitting PRs.
  • I read the [AI contribution guidelines] and understand my responsibilities, or I am not using AI tools.
  • I read the [Tree Hygiene] page, which explains my responsibilities.
  • I read and followed the [relevant style guides] and ran [the auto-formatter].
  • I signed the [CLA].
  • The title of the PR starts with the name of the package surrounded by square brackets, e.g. [shared_preferences]
  • I [linked to at least one issue that this PR fixes] in the description above.
  • I followed [the version and CHANGELOG instructions], using [semantic versioning] and the [repository CHANGELOG style], or I have commented below to indicate which documented exception this PR falls under[^1].
  • I updated/added any relevant documentation (doc comments with ///).
  • I added new tests to check the change I am making, or I have commented below to indicate which [test exemption] this PR falls under[^1].
  • All existing and new tests are passing.

@QuncCccccc QuncCccccc changed the title Add Material 3 Expressive migration skill [material_ui] Add Material 3 Expressive migration skill Sep 9, 2026
@QuncCccccc
QuncCccccc marked this pull request as ready for review September 10, 2026 19:12
@QuncCccccc QuncCccccc added the CICD Run CI/CD label Sep 10, 2026
@QuncCccccc
QuncCccccc requested a review from Piinks September 10, 2026 19:13

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces a new agent skill documentation file for Material 3 Expressive migration and links it in the skills README. The review feedback correctly points out that the documentation references a non-existent packages/material_ui package instead of packages/flutter where the Material library resides, and provides suggestions to correct these references.

Comment thread .agents/skills/README.md
Comment thread .agents/skills/material-3-expressive-migration/SKILL.md
Comment thread .agents/skills/material-3-expressive-migration/SKILL.md

@Piinks Piinks left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For the PR description, can you show an example of how contributors should use/prompt for this skill?

Use this skill for Material 3 Expressive component migration work in `packages/material_ui`.

Before planning or implementing a component migration, read the canonical checklist:
https://github.com/flutter/flutter/blob/master/docs/ecosystem/material_ui/Material-3-Expressive-component-migration-checklist.md

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Needs flutter/flutter#192519 to land first

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For the PR description, can you show an example of how contributors should use/prompt for this skill?

Updated! Thanks!

@Piinks Piinks left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

pull Bot pushed a commit to edisplay/flutter that referenced this pull request Sep 18, 2026
This PR is to add a [m3e migration
guide](https://docs.google.com/document/d/13UequzlX71hFYTvAO4mfz9sckWVJz7XcqRVh6OkjBF8/edit?usp=sharing)
to `docs/ecosystem/material_ui`.

Related to https://github.com/orgs/flutter/projects/250
Followup: create a skill that point to this doc to help agent during
migration: flutter/packages#12818


## Pre-launch Checklist

- [x] I read the [Contributor Guide] and followed the process outlined
there for submitting PRs.
- [x] I read the [AI contribution guidelines] and understand my
responsibilities, or I am not using AI tools.
- [x] I read the [Tree Hygiene] wiki page, which explains my
responsibilities.
- [x] I read and followed the [Flutter Style Guide], including [Features
we expect every widget to implement].
- [x] I signed the [CLA].
- [x] I listed at least one issue that this PR fixes in the description
above.
- [x] I updated/added relevant in-code documentation (doc comments with
`///`).
- [x] If this PR introduces a new feature or capability, I created and
linked a website documentation issue or PR in [flutter/website] (or
verified none is needed).
- [x] I added new tests to check the change I am making, or this PR is
[test-exempt].
- [x] I followed the [breaking change policy] and added [Data Driven
Fixes] where supported.
- [x] All existing and new tests are passing.
@QuncCccccc QuncCccccc added the autosubmit Merge PR when tree becomes green via auto submit App label Oct 2, 2026
@auto-submit
auto-submit Bot merged commit df4d712 into flutter:main Oct 2, 2026
13 checks passed
ZhuJHua pushed a commit to ZhuJHua/flutter that referenced this pull request Oct 6, 2026
…er#193840)

flutter/packages@5620e65...951f2f7

2026-10-05 Hamidrezash1384@gmail.com [material_ui] Add scrollPadding
property to DropdownMenuFormField (flutter/packages#12735)
2026-10-02 36861262+QuncCccccc@users.noreply.github.com [material_ui]
Migrate M3 Motion template to use new gen_defaults
(flutter/packages#13058)
2026-10-02 44747303+theprantadutta@users.noreply.github.com
[cupertino_ui] Forward showDragHandle from showCupertinoSheet to
CupertinoSheetRoute (flutter/packages#13011)
2026-10-02 105214765+HibaChamkhi@users.noreply.github.com [cupertino_ui]
Fix CupertinoMagnifier focal point with custom size
(flutter/packages#13029)
2026-10-02 katelovett@google.com [ci] Add material_ui and cupertino_ui
to customer testing (flutter/packages#13114)
2026-10-02 36861262+QuncCccccc@users.noreply.github.com [material_ui]
Add Material 3 Expressive migration skill (flutter/packages#12818)
2026-10-02 sethineelansh@gmail.com [video_player] Ignore late position
updates after disposal (flutter/packages#12971)
2026-10-02 46639812+Gyeony95@users.noreply.github.com [material_ui]
Remove unconditional dart:io import from about.dart
(flutter/packages#12774)
2026-10-02 50643541+Mairramer@users.noreply.github.com [material_ui] Fix
DropdownButtonFormField underline alignment at bottom
(flutter/packages#12606)
2026-10-02 engine-flutter-autoroll@skia.org Roll Flutter from
e89fd0a to d03768e (23 revisions) (flutter/packages#13111)
2026-10-02 dkwingsmt@users.noreply.github.com [material_ui] Migrate
`Switch` API doc snippets to {@example} (batch 8)
(flutter/packages#13052)
2026-10-02 45616602+NikhilKukreja26@users.noreply.github.com
[url_launcher] Fix supportsCloseForLaunchMode to query close support
(flutter/packages#12926)
2026-10-02 15619084+vashworth@users.noreply.github.com Redistribute
iOS/macOS Suggested Reviewers (flutter/packages#13076)
2026-10-02 anilcan.cakir@gmail.com [image_picker] Subsample large images
when resizing on Android (flutter/packages#13038)
2026-10-02 kevmoo@users.noreply.github.com [cupertino_ui] Remove
redundant null arguments in Completer.complete (flutter/packages#13008)
2026-10-02 269567208+reidbaker-agent@users.noreply.github.com [repo]
Update AGENTS.md with dependency allowance and versioning guidance
(flutter/packages#12579)

If this roll has caused a breakage, revert this CL and set the roller
to dry run mode using the controls here:
https://autoroll.skia.org/r/flutter-packages-flutter-autoroll
Please CC flutter-ecosystem@google.com on the revert to ensure that a
human
is aware of the problem.

To file a bug in Flutter:
https://github.com/flutter/flutter/issues/new/choose

To report a problem with the AutoRoller itself, please file a bug:
https://issues.skia.org/issues/new?component=1389291&template=1850622

Documentation for the AutoRoller is here:
https://skia.googlesource.com/buildbot/+doc/main/autoroll/README.md
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

autosubmit Merge PR when tree becomes green via auto submit App CICD Run CI/CD

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants