Home / dembrandt / dembrandt-skills · skills/surface-separation/SKILL.md · GitHub

surface-separation skillA

surface-separation is agent-read markdown (skill) from dembrandt/dembrandt-skills: A surface is set apart from its background by exactly one means — a border, an elevation, or a fill. Combining all three reads as noise. Opacity is a state signal, not a tinting tool; layering translucency over translucency makes contrast unpredictable and impossible to verify. Use when designing cards, panels, list rows, toolbars, or any container that needs to read as distinct from what sits behind it..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Surface Separation

A surface — a card, a panel, a toolbar, a row — needs to read as distinct from whatever sits behind it. There are exactly three ways to achieve that, and the mistake is almost always using more than one at full strength rather than choosing badly between them.

## Pick One Strategy Per Surface

| Strategy | Mechanism | Reads as | Best for |
|---|---|---|---|
| **Border** | 1px line at the boundary | Precise, drawn, documentary | Dense UI, tables, forms, anything where the edge itself carries meaning |
| **Elevation** | Shadow implying height | Floating, temporary, above | Modals, dropdowns, popovers, drag states |
| **Fill** | Contrasting background tone | Grouped, embedded, part of the page | Sections, sidebars, alternating rows, inline callouts |

Each answers a different question. A border says *where the surface ends*. An elevation says *how far above the page it sits*. A fill says *what it belongs to*. Choose based on which question the user actually has.
…

Read the whole file at its exact version.

How to install

Latest version
mdr add dembrandt/dembrandt-skills/surface-separation@git:20260919.d9eeaf5
Exact content
mdr add dembrandt/dembrandt-skills/surface-separation@sha256:7a56b5dd05382855

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_aoqb2pzdm4icf6a2.svg)](https://markdownregistry.com/a/art_aoqb2pzdm4icf6a2)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260919.d9eeaf5 latest2026-09-19 d9eeaf5 7,433 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (7433 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

dembrandt/dembrandt-skills · 56 stars · license MIT · pushed 2026-09-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_aoqb2pzdm4icf6a2
GET https://markdownregistry.com/api/v1/resolve?ref=dembrandt/dembrandt-skills/surface-separation
GET https://markdownregistry.com/api/v1/blob/7a56b5dd05382855d22b0f7b4822f1d2ae6be11fb14f17c86ee0ece25c319016

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from dembrandt/dembrandt-skills

algorithmic-color-palette skill
dembrandt/dembrandt-skills · skills/algorithmic-color-palette/SKILL.md · Derive a full UI colour palette algorithmically from one or two brand colours. Darker and lighter variants for…
git:20260710.d54dfaf · audit A · 56 stars
app-shell skill
dembrandt/dembrandt-skills · skills/app-shell/SKILL.md · The persistent shell around an application — the top bar, the app launcher, the tenant and environment cue, and in…
git:20260825.c784401 · audit A · 56 stars
authentic-product-representation skill
dembrandt/dembrandt-skills · skills/authentic-product-representation/SKILL.md · Product visuals — hero shots, demos, screenshots, landing-page panels — must reproduce the real product, not a stylised…
git:20260718.ac691f5 · audit A · 56 stars
brand-visual-language skill
dembrandt/dembrandt-skills · skills/brand-visual-language/SKILL.md · A brand's visual tone — playful or serious, rounded or angular — should be consistent across all UI elements. Shape…
git:20260919.ff0a188 · audit A · 56 stars
button-states skill
dembrandt/dembrandt-skills · skills/button-states/SKILL.md · Every interactive element needs a complete set of visual states — rest, hover, active/pressed, focus, disabled, and…
git:20260919.ab45a8b · audit A · 56 stars
clone-website skill
dembrandt/dembrandt-skills · skills/clone-website/SKILL.md · Rebuild an existing web page 1:1 from measurement instead of by eye — into Figma, Penpot, or code. Captures the…
git:20260907.05d2c97 · audit A · 56 stars
color-mode-and-theme skill
dembrandt/dembrandt-skills · skills/color-mode-and-theme/SKILL.md · Choose light, dark, or combined color mode deliberately based on brand tone and user context. Offer a theme selector…
git:20260919.ff0a188 · audit A · 56 stars
component-family-consistency skill
dembrandt/dembrandt-skills · skills/component-family-consistency/SKILL.md · Buttons, inputs, pills, badges, calendars, and other interactive components form a visual family — they share the same…
git:20260913.e798ded · audit A · 56 stars
coordinated-data-views skill
dembrandt/dembrandt-skills · skills/coordinated-data-views/SKILL.md · When data has both a tabular/list representation and a visual representation, show both simultaneously and keep them…
git:20260630.715170e · audit A · 56 stars
data-display-and-selection skill
dembrandt/dembrandt-skills · skills/data-display-and-selection/SKILL.md · Complex data deserves multiple view modes — grid, list, table — chosen by the user based on their task. Row and item…
git:20260919.ff0a188 · audit A · 56 stars
dembrandt skill
dembrandt/dembrandt-skills · skills/dembrandt/SKILL.md · Orchestrator for the full dembrandt UX pipeline. Routes a UI/UX task through six ordered stages — brand foundation →…
git:20260907.05d2c97 · audit A · 56 stars
domain-expert-configuration skill
dembrandt/dembrandt-skills · skills/domain-expert-configuration/SKILL.md · Configuration UIs for domain experts — users who understand their field deeply but are not software developers —…
git:20260630.715170e · audit A · 56 stars

Every file in dembrandt/dembrandt-skills

Browse by kind, by grade A, or by owner.