Integrates Material UI with Next.js App and Pages routers using @mui/material-nextjs, Emotion cache providers, next/font, CSS layers with Tailwind/CSS Modules, Link component prop patterns, CSS theme variables SSR notes, and App Router useSearchParams + Suspense. Use when setting up or debugging MUI in a Next.js app.
Install
npx skills add https://github.com/mui/material-ui --skill material-ui-nextjsSKILL.md
Material UI and Next.js
Agent skill for Next.js + Material UI wiring (SSR/streaming, cache providers, fonts, layers, Link, App Router URL state). SKILL.md is the entry; AGENTS.md is the full guide.
When to apply
- New App Router or Pages Router app using
@mui/material - Styles missing, wrong order, or in
bodyinstead ofhead next/font+ThemeProvider/createTheme- Tailwind or CSS Modules + MUI (
enableCssLayer) Button+component={Link}or Next.js v16 client boundary errorsuseSearchParams/ URL-driven MUI views and Suspense boundaries
Sections in AGENTS.md
| Area | Topics |
|---|---|
| App Router | AppRouterCacheProvider, @emotion/cache, options, useSearchParams + <Suspense> |
| Pages Router | _document, _app, DocumentHeadTags, AppCacheProvider |
| Fonts | 'use client' theme, next/font, CSS variables on html |
| CSS variables | cssVariables, SSR flicker docs |
| CSS layers | enableCssLayer, Tailwind / other CSS |
| Link | Client wrapper, routing guide, examples repo |
Full guide
Read AGENTS.md for complete steps and doc links.
reference.md lists import paths and provider shape.
Related skills
vercel-react-best-practicesvercel-labs751KReact and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.vercel-composition-patternsvercel-labs361KReact composition patterns that scale. Use when refactoring components with boolean prop proliferation, building flexible component libraries, or designing reusable APIs. Triggers on tasks involving compound components, render props, context providers, or component architecture. Includes React 19 API changes.vercel-react-view-transitionsvercel-labs135KGuide for implementing smooth, native-feeling animations using React's View Transition API (`<ViewTransition>` component, `addTransitionType`, and CSS view transition pseudo-elements). Use this skill whenever the user wants to add page transitions, animate route changes, create shared element animations, animate enter/exit of components, animate list reorder, implement directional (forward/back) navigation animations, or integrate view transitions in Next.js. Also use when the user mentions viewpick-ui-libraryemilkowalski124KPick the right library for a given frontend task from a curated, opinionated list — numbers, OTP inputs, charts, command menus, virtualization, drag and drop, toasts, state, styling, and more. Only runs when explicitly invoked; it does not trigger on its own.