Przejdź do treści
Biblioteka skilli
Programowanie · Przegląd i audyt

mui-optimizer

/mui-optimizer

Audytuje użycie MUI w projekcie, mierzy koszt importów i renderowania oraz przygotowuje plan poprawek do zatwierdzenia przed zmianami w kodzie.

Licencja
MIT
Ostatnia zmiana repozytorium
04.11.2026

Ocena i bezpieczeństwo

85/ 100Klasa: dobry
Format20 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
8
Skrypty
1
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 04.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/audit.py

Co robi i kiedy

Audytuje użycie MUI w projekcie, mierzy koszt importów i renderowania oraz przygotowuje plan poprawek do zatwierdzenia przed zmianami w kodzie.

Wyzwalacze z opisu

optimize my UI
Oryginalny opis (EN)

Audit and optimize MUI (styled React kit (Emotion), @mui/material 9.x) usage in a codebase for MUI, @mui/material, ThemeProvider, MUI X data grid, @mui/icons-material, Emotion, AppRouterCacheProvider, bundle/import cost, runtime and re-render cost, theming/SSR, accessibility/forms, copy-in or version drift, with real before/after measurement. Always produces a written findings report and a fix plan for approval before touching code. Use this whenever the user mentions MUI, @mui/material, ThemeProvider, MUI X data grid, @mui/icons-material, Emotion, AppRouterCacheProvider or "optimize my UI" --

Jak działa

  1. Workflow
  2. Principles
  3. Docs
Sekcje z nagłówków SKILL.md, w oryginale · 61 linii, 586 słów
Podgląd SKILL.md
---
name: mui-optimizer
description: Audit and optimize MUI (styled React kit (Emotion), @mui/material 9.x) usage in a codebase for MUI, @mui/material, ThemeProvider, MUI X data grid, @mui/icons-material, Emotion, AppRouterCacheProvider, bundle/import cost, runtime and re-render cost, theming/SSR, accessibility/forms, copy-in or version drift, with real before/after measurement. Always produces a written findings report and a fix plan for approval before touching code. Use this whenever the user mentions MUI, @mui/material, ThemeProvider, MUI X data grid, @mui/icons-material, Emotion, AppRouterCacheProvider or "optimize my UI" -- even if they never say "audit" or "optimize".
---

# MUI Optimizer

MUI 9 is a large styled React kit on Emotion (Pigment CSS optional). The wins are import shape (icons, MUI X), SSR cache setup in Next, avoiding `sx` churn in large lists, and keeping the theme/provider from pulling the kit into every client boundary.

## Workflow

### 1. Scope (quick)

- Find the app root and detect MUI usage: `@mui/material 9.x`. Record the version, framework (React/Next/Vue/Svelte/Solid/Angular or HTML), styling system, and whether the library is a package, a CSS-only kit, or copied source.
- Run `python <skill-dir>/scripts/audit.py <project-root>` -- static scan of `package.json`, config/CSS files and source for version drift, provider/config drift, import and theme issues, a11y gaps, heavy components and upgrade risk, with file:line evidence. Use `--json` to post-process.
- Classify the pain: bundle/import cost, runtime/re-render cost, theming/SSR style flash, accessibility/forms, large tables/lists, or migration/upgrade. Ask which hurts if unclear.
- Read `references/tooling.md` once: what can be measured here.

- Check the provider/cache, `@mui/icons-material` imports, MUI X packages and whether `@mui/styles` remains. Record the theme setup.

### 2. Audit

The script finds cheap leads; you find the rest by reading. Read the install/config, the global CSS/theme file, the provider or plugin setup, and the 3-5 most-used components. Load only what applies:

| Area | Reference |
|------|-----------|
| Install, config, provider/plugin, theming, SSR | `references/setup.md` |
| Bundle/imports, runtime, a11y/forms, tables, upgrades | `references/optimizations.md` |
| Measurement and honest reporting | `references/tooling.md` |

**Measure, never guess.** Build for production and measure the real route/bundle. Inspect SSR HTML for style tags and dark-mode flash; run axe/Playwright on dialogs, menus, forms and tables. Component count, bundle bytes and a11y violations are evidence; "feels heavy" is not.

Mark each finding **Confirmed** (build/analyzer/axe/code evidence) or **Suspected** (needs measuring).

### 3. Report

Fill `assets/report-template.md`, save it as `MUI_OPTIMIZATION_REPORT.md` in the project root, and show the user. Five-line summary, findings table by impact/effort, then per-finding detail (evidence, why it hurts, fix, risk, visual/behavior impact). Group near-duplicates.

### 4. Plan -- then stop for approval

Use plan mode: `EnterPlanMode` (load with ToolSearch if deferred), write the plan, present with `ExitPlanMode`; if unavailable show it in chat and wait for an explicit "go". Structure:

1. **Quick wins** -- trim imports, use path imports, add provider/plugin correctly, add missing labels/titles, move heavy components off the initial route, remove per-row overlays, align theme tokens, add SSR style/cache setup. Low risk.
2. **Structural** -- split component boundaries, virtualize tables, lazy-load heavy widgets, consolidate theming, migrate variants/tokens, fix form composition, deduplicate copied components. Name each behavior change.
3. **Heavy** -- major upgrade, primitive-base change, CSS-only to styled kit (or reverse), Tailwind 3 to 4, copy-in registry extraction, SSR architecture. Separately approved.
   Each step: files touched, expected effect, how to verify, how to roll back.

### 5. Fix

Only approved items, in small groups. After each: typecheck, lint, tests, production build, and a visual/axe check on affected components. A break must trace to one change. Do not mix a major migration with optimization edits. If a change alters a public component API, theme tokens or SSR behavior, stop and ask.

### 6. Verify and wrap up

Re-measure the same routes/components: route JS/CSS, SSR styles/theme, axe violations, dialog/form keyboard flow, table interaction. State plainly what could not be measured. End with deferred items and one suggested next step.

## Principles

- **Imports decide the bundle.** Icons and X packages are the big levers.
- **SSR needs the cache.** Emotion extraction is not automatic.
- **Theme is a contract.** Keep one stable theme.

## Docs

- https://mui.com/material-ui/getting-started/
Pliki w paczce (8)
  • LICENSE 1 KB
  • README.md 1 KB
  • SKILL.md 5 KB
  • assets/report-template.md 1 KB
  • references/optimizations.md 1 KB
  • references/setup.md 1 KB
  • references/tooling.md 1 KB
  • scripts/audit.py 9 KB

Wersje

W bazie nie ma innych skilli o nazwie mui-optimizer.

Migawka bazy z 13.11.2026 · wersja paczki 2f66b4f50768 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 85flowbite-optimizer
    Audytuje użycie Flowbite w projekcie, mierzy koszt importów i renderowania oraz przygotowuje plan poprawek do zatwierdzenia przed zmianami w kodzie.
  • 85heroui-optimizer
    Audytuje użycie HeroUI w projekcie, mierzy koszt importów i renderowania oraz przygotowuje plan poprawek do zatwierdzenia przed zmianami w kodzie.
  • 100materialui
    Wspiera pracę z Material UI (MUI): komponenty stylowane Emotion, dostosowanie motywu, DataGrid i dostępne ikony w korporacyjnych dashboardach React.
  • 100material-ui
    Pomaga dodać Material UI (MUI) do projektu React lub Next.js, zbudować motyw przez createTheme, stylować propem sx, włączyć tryb ciemny i zaktualizować kod do API wersji 9.
  • 95mui
    Pokazuje wzorce biblioteki komponentów Material-UI v7: stylowanie propem sx, integrację motywów, projektowanie responsywne i hooki MUI.
  • 100material-ui-nextjs
    Integruje Material UI z Next.js (App Router i Pages Router) przez @mui/material-nextjs, dostawców pamięci podręcznej Emotion, next/font, warstwy CSS z Tailwind i zmienne motywu w SSR.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.