Individual skill

mui-base

MUI Base UI style guidelines for building headless React component libraries (formerly headless-ui-style). This skill should be used when creating unstyled UI components, compound components with render props, accessibility-first patterns, or component libraries that separate logic from styling. Extracted from the MUI Base UI codebase (github.com/mui/base-ui).

skills/.curated/mui-base/SKILL.md

Read pinned source

Source commit cf93c57cac89d6fc3e4194686000411567f5caf3

What was checked

Matches the observed repository HEAD: Yes
Scanner rules are current: No
Repository scan complete: No
Skill scan complete: Yes
Observed behavior: Not checked yet
Last checked: Nov 5, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings): 222
Repository last updated: Aug 15, 2026
License: MIT

Observed agent integration: codex

design Derived category
engineering Derived category
design-interface Derived category
engineering-web Derived category

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files

AGENTS.mddoc · 9,173 bytes
README.mddoc · 4,594 bytes
SKILL.mdcore · 4,853 bytes
assets/templates/_template.mddoc · 444 bytes
metadata.jsonasset · 1,537 bytes
references/_sections.mddoc · 1,288 bytes
references/comp-context-error-message.mddoc · 1,409 bytes
references/comp-context-undefined-default.mddoc · 1,618 bytes
references/comp-context-value-memo.mddoc · 1,431 bytes
references/comp-forward-ref-named.mddoc · 1,244 bytes
references/comp-hook-namespace-exports.mddoc · 1,404 bytes
references/comp-plain-function-root.mddoc · 1,620 bytes
references/comp-props-destructure-order.mddoc · 1,054 bytes
references/comp-props-parameter-naming.mddoc · 1,178 bytes
references/comp-state-memoization.mddoc · 1,222 bytes
references/comp-use-client-directive.mddoc · 1,171 bytes
references/comp-use-controlled.mddoc · 1,759 bytes
references/comp-use-render-element.mddoc · 1,792 bytes
references/err-cancelable-events.mddoc · 1,730 bytes
references/err-context-error-guidance.mddoc · 1,346 bytes
references/err-deduplicated-warnings.mddoc · 1,220 bytes
references/err-dev-only-warnings.mddoc · 1,584 bytes
references/err-event-reason-constants.mddoc · 1,378 bytes
references/err-message-prefix.mddoc · 976 bytes
references/err-prop-validation-timing.mddoc · 1,536 bytes
references/err-typed-event-reasons.mddoc · 1,517 bytes
references/name-component-naming.mddoc · 1,315 bytes
references/name-constants.mddoc · 895 bytes
references/name-context-hook.mddoc · 1,410 bytes
references/name-context-suffix.mddoc · 1,262 bytes
references/name-data-attributes.mddoc · 1,121 bytes
references/name-directory-kebab-case.mddoc · 709 bytes
references/name-event-type.mddoc · 1,072 bytes
references/name-file-matches-export.mddoc · 976 bytes
references/name-handlers.mddoc · 1,597 bytes
references/name-hooks.mddoc · 1,148 bytes
references/name-namespace-type-exports.mddoc · 1,323 bytes
references/name-part-directory-lowercase.mddoc · 849 bytes
references/name-props-interface.mddoc · 1,171 bytes
references/name-refs.mddoc · 1,099 bytes
references/name-state-interface.mddoc · 1,034 bytes
references/org-component-directory.mddoc · 1,105 bytes
references/org-context-placement.mddoc · 791 bytes
references/org-css-vars-file.mddoc · 1,148 bytes
references/org-data-attributes-file.mddoc · 1,435 bytes
references/org-dual-barrel-exports.mddoc · 1,767 bytes
references/org-package-exports.mddoc · 1,347 bytes
references/org-state-attributes-mapping.mddoc · 1,543 bytes
references/org-test-colocation.mddoc · 1,011 bytes
references/style-default-values.mddoc · 1,268 bytes
references/style-explicit-undefined.mddoc · 1,044 bytes
references/style-internal-imports.mddoc · 1,254 bytes
references/style-jsdoc-documentation.mddoc · 1,442 bytes
references/style-react-import.mddoc · 1,150 bytes

Read excerpt


# 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