This is a comprehensive style guide extracted from the MUI Base UI codebase with 48 rules across component patterns, naming conventions, organization, error handling, and styling. Use it when building headless component libraries that separate logic from presentation, especially if you're working with compound components, render props, or accessibility-first patterns. The guidelines are pragmatic and specific, covering everything from how to name context hooks (useComponentContext) to memoizing provider values. It's opinionated about structure (dual barrel exports, kebab-case directories) but that's the point. If you're building unstyled primitives or component libraries where consumers bring their own styling, these patterns will save you from reinventing solutions to problems MUI already solved.

skills.sh installs
335
GitHub stars
222
last updated
Aug 21, 2026

Install

$ npx -y skills add pproenca/dot-skills --skill mui-base --agent claude-code

Installs into .claude/skills of the current project.

Files

MUI Headless UI Best Practices

Comprehensive style guide for building headless React component libraries following MUI Base UI patterns. Contains 48 rules across 5 categories, prioritized by impact.

When to Apply

Reference these guidelines when:

  • Building headless/unstyled component libraries
  • Creating compound components with context-based composition
  • Implementing accessible UI primitives with ARIA patterns
  • Using render props and className callbacks for styling flexibility
  • Writing components that support both controlled and uncontrolled modes

Rule Categories by Priority

PriorityCategoryImpactPrefix
1Component PatternsCRITICALcomp-
2Naming ConventionsHIGHname-
3OrganizationHIGHorg-
4Error HandlingHIGHerr-
5StyleMEDIUMstyle-

Quick Reference

1. Component Patterns (CRITICAL)

Sponsors

Details

Repository
github.com/pproenca/dot-skills
Categories
Frontend Development, Git & Pull Requests, Code Review & Quality, Design & UI/UX
First seen
Jun 3, 2026

More from pproenca/dot-skills

All 100
1davila7 avatarweb-artifacts-builderdavila7/claude-code-templatesSuite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn/ui). Use for334skills.sh installs
2pedronauck avatarvercel-composition-patternspedronauck/skillsReact composition patterns that scale. Use when refactoring components with boolean prop proliferation, building flexible component libraries, or designing reus334skills.sh installs
3bobmatnyc avatarartifacts-builderbobmatnyc/claude-mpm-skillsSuite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn/ui)333skills.sh installs
4secondsky avatarbun-tanstack-startsecondsky/claude-skillsTanStack Start full-stack React framework with Bun runtime. Use for TanStack Router, server functions, vinxi, or encountering SSR, build, preset errors.329skills.sh installs
5secondsky avatarcloudflare-workers-frameworkssecondsky/claude-skillsFramework integration for Cloudflare Workers. Use when building with Hono, Remix, Next.js, Astro, SvelteKit, Qwik, or Nuxt on Workers. Covers routing, SSR, stat321skills.sh installs
6yoanbernabeu avatarslidev-stylingyoanbernabeu/slidev-skillsStyle Slidev slides with UnoCSS and custom CSS. Use this skill for custom colors, typography, animations, and responsive designs.320skills.sh installs