TheGoat395/Codex-Skills / skills/surface-shadow-material-systems
surface-shadow-material-systems
VerifiedDesign component surfaces and elevation states.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 719 B |
| agents/openai.yaml | config | 270 B |
| references/surface-shadow-material-systems-guide.md | markdown | 3.0 KB |
references/surface-shadow-material-systems-guide.md
View on GitHub# Surface Shadow Material Systems Guide
## Purpose
Make depth and surfaces support hierarchy instead of decorating everything.
## Use When
- A UI uses cards, panels, modals, popovers, sticky nav, product mockups, or dashboard surfaces.
- The page looks flat, muddy, over-shadowed, or default-library-like.
- Luxury/editorial/product polish depends on material nuance.
## Do Not Use When
- A strict flat design system forbids shadows/material treatment.
- The task is unrelated to visible surfaces.
- A small copy fix should not alter visual hierarchy.
## Discovery Questions
- What levels of surface are needed: page, section, panel, raised, overlay, selected, disabled?
- Should depth come from border, shadow, color, blur, texture, or spacing?
- What radius scale fits the brand and platform?
- Are cards actually needed, or would bands, grids, tables, or media sections be better?
## Decision Tree
- Define surface levels before styling components.
- Use borders and subtle color shifts before large shadows where possible.
- Reserve heavy elevation for overlays, active panels, or true hierarchy.
- Keep radius consistent and usually modest for professional sites.
- Avoid cards inside cards and decorative glass without concept.
## Implementation Rules
- Do not use glassmorphism, blur, blobs, or glow as default premium styling.
- Treat 8px or less as one restrained starting point; use optically tested radii that fit the approved brand, material and component scale.
- Surfaces must clarify grouping, state, or hierarchy.
- Use shadows that match light direction and background.
- Make dark-mode elevation rely more on borders/tints than opaque shadows.
## Useful Patterns
- Product UI: page background, panel surface, raised active state, popover overlay.
- Luxury editorial: minimal panels, fine dividers, material image plates, soft section contrast.
- Dashboard: dense panels with low-radius edges, clear dividers, restrained elevation.
## Anti-Patterns
- Every section as a floating card.
- Nested cards to solve spacing.
- Large blurry shadows on every object.
- Random glass panels over unrelated gradients.
## QA Checklist
- Scan for nested cards and excessive shadows.
- Check surface hierarchy in light and dark contexts.
- Inspect modals/popovers/sticky nav over page content.
- Verify borders and shadows remain visible on mobile screens.
## Acceptance Criteria
- Surfaces create readable hierarchy.
- Depth feels restrained and project-specific.
- The UI avoids generic card/glass visual tropes.
## Scoped execution
Apply the [shared web contract](../../website-operating-rules/references/scoped-web-contract.md) once when execution crosses phases; reuse it if already read. Load only the specialist guidance relevant to the requested surface and deliverable.
## Official Source Anchors
- Tailwind utility classes: https://tailwindcss.com/docs/styling-with-utility-classes
- Tailwind theme variables: https://tailwindcss.com/docs/theme
- MDN CSS custom properties: https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/--*
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |