shimonsalamon

M3 Expressive Foundations — Security skill for Claude Code

Security community

Material 3 Expressive design foundations for the web, as a Claude Code skill: tokens, color, type, shape, motion, elevation, states, layout and an audit checklist.

How to install M3 Expressive Foundations

This entry records only its repository, not the path inside it, so there is no exact command to give. Open shimonsalamon/m3-expressive-foundations and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What M3 Expressive Foundations does

Material 3 Expressive design foundations for the web, as a Claude Code skill: tokens, color, type, shape, motion, elevation, states, layout and an audit checklist.

Alternatives in Security

  • MCP Security Checklist (SlowMist) — Comprehensive checklist: input validation, rate limiting, RBAC, credential management, container hardening 819 ★
  • Data Viz Audit — Audit a data visualization for chart type selection, accessible color palette, annotations, and anti-patterns 309 ★
  • Commit Hook Checklist — Audit commit-hook automation as gates against AI slop and broken commits (Node.js, Go, polyglot) 168 ★

README

M3 Expressive Foundations — a Claude Code skill

A [Claude Code](https://docs.claude.com/en/docs/claude-code) skill that teaches Claude the **Material 3 Expressive** design foundations for the web, in any framework (Angular, React, Vue, Svelte, Lit or plain HTML/CSS), with a drop-in CSS token file.

Use it to build, theme, restyle or **audit** a UI to Material 3 / M3 Expressive. Claude picks it up on its own when a request is about Material design ("make it look like Material", "audit this dialog against M3", "set up dark mode and contrast levels").

Unofficial. Not affiliated with or endorsed by Google. See [NOTICE](NOTICE).

What it covers

Foundations only — the rules every component is built from, not individual component specs:

  • Color — roles and on-role pairs, dark mode, standard/medium/high contrast, seed and brand schemes
  • Typography — the type scale and emphasized styles, typefaces, tall scripts
  • Shape — the corner-radius scale, the 35-shape library, shape morphing
  • Motion — spring motion and easing, reduced motion
  • Elevation — the six levels, shadows and scrims
  • Interaction states — state layers, focus rings, touch targets
  • Layout — breakpoints (window size classes), panes, margins, the spacing scale
  • Expression — how much expression a screen should carry, and where its hero moments go

What's inside

Path What it is
SKILL.md Entry point: principles, when to use it, how to build or audit
references/*.md One reference per foundation, a quick reference of exact values, and an audit checklist with console snippets
assets/m3-expressive-tokens.css Every token and web helper as CSS custom properties (light/dark, three contrast levels, two motion schemes)
assets/material-shapes.* The shape library as CSS shape() values, SVG clip paths and raw JSON
scripts/generate-scheme.mjs Generates a color scheme from a seed or brand color (needs `@material/material-color