theme-ui-specialist

Guide React UI decisions for consistent MUI theming and design-system adherence.

3|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/gwpjp/Web3-Claude --skill theme-ui-specialist
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: theme-ui-specialist
Source: https://github.com/gwpjp/Web3-Claude/tree/main/.claude/skills/theme-ui-specialist
Command: npx skills add https://github.com/gwpjp/Web3-Claude --skill theme-ui-specialist

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill ensures consistent theming and design-system compliance across UI components by guiding decisions on MUI theming, component selection, and styling rules.

Core Features & Use Cases

  • Theming guidance: Centralized rules for createTheme, palette, typography, component overrides, and module augmentation.
  • Component selection: Advice on when to use Common components vs MUI primitives to maintain design consistency.
  • Design-system enforcement: Rules to ensure CLAUDE.md styling and project rules are followed across UI decisions.
  • Use cases: When deciding between layout-level changes or component-level styling across the app.

Quick Start

Initialize the theme specialist by reviewing the docs: read .claude/docs/theme-reference.md, .claude/docs/component-reference.md, and .claude/docs/project-rules.md before making changes. Then consult /ui-designer for layout or component creation tasks.

Frequently Asked Questions about theme-ui-specialist

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I ensure consistent MUI theming across React components?

To ensure consistent MUI theming, you must read the theme reference, component reference, and project rules before acting. This enforces theme-first principles by guiding createTheme, palette, typography, and component override decisions.

When should I use Common components vs MUI primitives in a design system?

Use Common components to maintain design consistency across the app, while MUI primitives serve as foundational building blocks. This Skill guides component selection by evaluating layout-level changes versus component-level styling to ensure design-system adherence.

What is the best way to override MUI component styles without breaking design consistency?

The best way to override MUI component styles is by following theme-first principles and consulting the project's themeConfig. This Skill enforces rules from CLAUDE.md and project documentation to ensure overrides remain compliant with the design system.

Does this Skill require any specific React dependencies or design system setup?

No specific dependencies are required to start, but your project must use MUI for theming. You need to initialize the theme specialist by reading the theme-reference, component-reference, and project-rules docs before making UI changes.

Why does my MUI palette and typography configuration fail to apply across the app?

MUI palette and typography configurations fail when theme-first principles are bypassed. This Skill requires reviewing the themeConfig and project rules before acting, ensuring centralized rules for createTheme and module augmentation are properly followed.

When should I consult a UI designer for layout changes instead of adjusting MUI theming?

You should consult a UI designer when facing layout-level changes that exceed component-level styling boundaries. This Skill guides decisions on when to defer to `/ui-designer` for component creation or structural layout modifications.