Skip to content
Skills Library
Design & UX · Building & coding

depth

/depth

Add or refine depth through elevation systems, raised and inset surfaces, layered overlap, and meaningful shadow behavior so interfaces feel structured instead of flat. Use when the user mentions depth, elevation, shadows, layering, flat cards, pressed states, drag feedback, or inset controls.

Licence
MIT
Last repository change
21.05.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 21.05.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Add or refine depth through elevation systems, raised and inset surfaces, layered overlap, and meaningful shadow behavior so interfaces feel structured instead of flat. Use when the user mentions depth, elevation, shadows, layering, flat cards, pressed states, drag feedback, or inset controls.

Original author description

Add or refine depth through elevation systems, raised and inset surfaces, layered overlap, and meaningful shadow behavior so interfaces feel structured instead of flat. Use when the user mentions depth, elevation, shadows, layering, flat cards, pressed states, drag feedback, or inset controls.

How it works

  1. MANDATORY PREPARATION
  2. Assess Depth Problems
  3. Plan the Depth System
  4. Build Depth Systematically
  5. Verify Depth Quality
Original SKILL.md headings · 94 lines, 732 words
SKILL.md preview
---
name: depth
description: Add or refine depth through elevation systems, raised and inset surfaces, layered overlap, and meaningful shadow behavior so interfaces feel structured instead of flat. Use when the user mentions depth, elevation, shadows, layering, flat cards, pressed states, drag feedback, or inset controls.
metadata:
   argument-hint: "[target]"
---

Create or improve visual depth so layers, surfaces, and states feel intentional, readable, and physically believable without drifting into over-styled noise.

## MANDATORY PREPARATION

Users start this workflow with `/depth`. Once this skill is active, load $frontend-design — it contains design principles, anti-patterns, and the **Context Gathering Protocol**. Follow that protocol before proceeding — if no design context exists yet, you MUST load $setup first.

---

## Assess Depth Problems

Analyze where the interface feels flat, confusing, or physically inconsistent:

1. **Elevation structure**:
   - Are all components using the same shadow regardless of job?
   - Is it hard to tell what sits on the page versus above it?

2. **Surface treatment**:
   - Which elements should feel raised?
   - Which should feel inset, like inputs or wells?
   - Are there places where color alone could suggest depth more cleanly than stronger effects?

3. **Interaction states**:
   - Do pressed buttons feel like they move inward or just change color?
   - Does dragging feel like an item pops forward above its neighbors?

4. **Restraint**:
   - Are shadows and effects helping users understand structure, or just making the UI look busier?

If any of these are unclear from the codebase, ask the user directly to clarify what you cannot infer.

**CRITICAL**: Depth should explain surfaces, states, and layering. If the effect is louder than the meaning, it has gone too far.

## Plan the Depth System

Consult the [elevation system](../frontend-design/reference/elevation-system.md) for shadow levels, two-part shadow logic, raised/inset mapping, and flat depth via color.
Consult the [surface separation](../frontend-design/reference/surface-separation.md) when deciding whether depth should come from spacing, background shifts, overlap, borders, or shadows.
Consult the [image treatment](../frontend-design/reference/image-treatment.md) when overlapping media or image boundaries need cleaner depth cues.

Create a plan around:
- **Elevation levels**: Which 3–5 semantic levels exist?
- **Surface roles**: Which things are base, raised, inset, pressed, or dragged?
- **Layering**: Where can overlap clarify structure?
- **Restraint**: Which effects should be reduced or removed entirely?

## Build Depth Systematically

### Establish an Elevation System
- Define a small set of semantic levels for surfaces, controls, menus, overlays, and temporary UI
- Keep similar components on the same elevation unless there is a real reason to separate them

### Raised and Inset Elements
- Raised elements should feel like they sit above the page with a shadow beneath them
- Inset elements should feel recessed through inner shadow, lip treatment, or darker surrounding surface
- Use raised and inset treatments deliberately — not every control needs obvious realism

### Two-Part Shadow Logic
- Use a larger, softer shadow to suggest distance from the surface
- Use a smaller, tighter shadow near the edge to suggest compressed ambient shadow
- As elevation increases, the tight near-edge shadow should usually become subtler

### Pressed and Dragged States
- Pressed states should reduce elevation and feel like the element moves inward/downward
- Dragged states should increase elevation so the item feels like it pops forward
- Match shadow, transform, and any color shift so the motion reads as a single physical change

### Overlap and Layering
- Use overlap when it helps clarify multiple layers of information
- Let cards, controls, or media cross boundaries when it reinforces depth and grouping
- Keep overlaps readable; add separation or background-matching edges if layers start to clash

### Flat Depth via Surface Color
- Lighter surfaces often feel closer, darker surfaces often feel further away
- Before adding more shadow, test whether a subtle surface-color shift communicates the same thing more cleanly

### Don’t Get Carried Away
- Borrow cues from the real world, but stop before the interface feels photo-realistic or busy
- If the structure is already clear, simpler depth usually wins

**NEVER**:
- Use the same drop shadow for every component
- Add heavy shadows where color or spacing would communicate depth better
- Make every button, card, panel, and modal feel equally elevated
- Let realism overpower clarity
- Use depth effects with no semantic meaning

## Verify Depth Quality

- **Layer clarity**: Is it obvious what sits on the page and what floats above it?
- **State clarity**: Do pressed and dragged states feel physically different?
- **Consistency**: Are similar components using the same elevation language?
- **Restraint**: Does the UI feel more understandable, not just more decorated?

Remember: Great depth creates structure, not spectacle. Use it to make layers and states feel obvious, then stop.

Versions

The database has no other skills named depth.

Database snapshot: 13.11.2026 · package version 8b2272712894 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100shadow-elevation-density
    Elevation, shadow, depth, and density systems: shadow scales, elevation hierarchy, glassmorphism, blur effects, border-radius systems, and compact, comfortable, and spacious density modes with production CSS. Use when surfaces look flat or float wrongly, or when tuning information density.
  • 100elevation-and-depth
    Shadows and layering that lift elements above the surface. Use when designing cards, dropdowns, modals, tooltips or any floating element.
  • 100depth-ui
    Applies depth-driven layered color and shadow principles to elevate average UI into polished, readable interfaces for both light and dark themes. Use when improving or reviewing UI components, setting up a design token system, applying consistent depth and shadow to an…
  • 90design-surfaces
    Use when styling cards, dialogs, modals, panels, borders, shadows, elevation, overlays, nested radii, “radius terasa aneh”, “shadow kasar”, or surfaces that lose hierarchy between light and dark themes.
  • 100interface-polish
    Design-engineering micro-detail pass for interfaces that already work but feel unrefined. Applies concrete CSS/JS rules for hover/active/focus states, transition timing and easing, enter/exit animations, stagger patterns, layered shadows, border-vs-shadow elevation, nested…
  • 100tailwindcss-effects
    Use when adding box/inset shadows, controlling opacity, applying CSS filters or backdrop filters (glassmorphism), or mask-* utilities.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.