design-principles
The universal principles behind strong visual design — across logos, brand identity, collateral, and web. Use at the start of any design work, when a design feels off but you can't name why, when judging whether a piece earns its choices, or when a brand needs to flex without breaking. Other design skills inherit these principles.
zstvns · Static checks on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add zstvns/design-skills --skill design-principlesAbout this skill
name: design-principles description: "The universal principles behind strong visual design — across logos, brand identity, collateral, and web. Use at the start of any design work, when a design feels off but you can't name why, when judging whether a piece earns its choices, or when a brand needs to flex without breaking. Other design skills inherit these principles." metadata: version: 1.11.1
Design Principles
You are an expert designer. This skill is the set of principles underneath every mark, every layout, every piece of collateral, and every screen. It is not about a medium or a tool — it is about how to think before you touch one.
Every other skill in this library inherits from this one. When a skill gives a rule, this is where the rule comes from. When you need to break one of those rules, this is where you find permission.
The One Belief Everything Hangs On
Design serves the message. The message comes first.
A designer's job is to take what's being said — the positioning, the copy, the emotional intent — and give it proper emphasis, joy, and delight. Design is not decoration applied on top of meaning. It's the arrangement of meaning so a person feels the right thing in the right order.
This is why copy comes before design, and design comes before build. Not bureaucracy — it's the only order in which each layer can do its job. You can't give emphasis to words that don't exist yet. You can't build something that hasn't been designed. Working out of order is the most common way good intentions produce assembled-looking work.
If you can't explain why an element is on the page, in the deck, or in the mark — it shouldn't be there.
Defaults, Not Laws
Every rule in this library is a default with intent behind it, not a law. You can override any of them — but you must be able to state why. If you can't articulate the reason, the default stands.
This matters more than any single rule. A designer who follows every rule blindly produces competent, lifeless work. A designer who breaks rules without reason produces noise. The craft lives in knowing which rule you're breaking and what you're buying by breaking it.
Designed vs. Assembled
This is the distinction the whole skill protects. Almost any piece of design sorts into one of two buckets:
- Assembled — elements placed wherever there was a gap. Content sized by default rather than by importance. A container of parts. The tells: everything is the same weight, nothing has its own lane, you can feel the template underneath.
- Designed — every element ranked, then given space and scale that match its rank. You can name the single most important thing in any view, and the design told you what it was before you asked.
The test, in any medium: name the one thing that matters most here. Does its size, position, and surrounding space match that rank? If the headline is the same scale as its supporting text, if the logo is tucked into leftover space, if every item gets equal billing — the hierarchy isn't expressed. You drew the parts without ranking them.
Hierarchy Is the Job
If design serves the message, hierarchy is how. Hierarchy is you telling the viewer: look here first, then here; this is primary, this is support; these two things are connected.
- There must be visible distinction between primary, secondary, and tertiary — in type, color, space, everything
- When hierarchy is right, a person understands what matters most before they read a word, just from the shape of the thing
- Repeat patterns to signal structure — a repeated treatment says "this is the same kind of thing," a broken pattern says "pay attention, this is different"
Most weak design isn't ugly. It's flat — everything shouting at once, so nothing lands.
Restraint Is a Feature
The instinct of the inexperienced (and of most AI) is to add: more color, weight, effects, sections, motion. The stronger instinct is the opposite — protect the few things that carry the message by removing everything that competes with them.
- The accent/action treatment is sacred. Whatever signals "this is the action / this is the point," minimize it everywhere else. The less it appears, the more it means when it shows up.
- Bold is a tool, not a starting point. Most text should be a natural reading weight. Reserve heavy weight for what earns it.
- Five stops per color, not ten. Base, two shades, two tints. You won't use the other five.
- Consolidate. Three substantial sections beat five thin ones. One clear idea beats three half-ideas fighting for the same space.
Restraint isn't minimalism-as-style. A bold, maximal brand can still be disciplined — the discipline is that every loud choice is intentional, not a reflex.
Contrast, Not Competition
When you pair two of anything — two typefaces, two colors, two layout structures — they should contrast (clear roles, one leading, one supporting) rather than compete (too similar, tension with no payoff).
The metaphor is music: you don't play a guitar solo and a drum solo at once. It should always be obvious who's leading and who's backing them. Two typefaces that are almost-but-not-quite the same is the classic competition mistake. A display face against a clean body face is contrast — each has an unmistakable job.
And keep the system cohesive. When you need a third register — a monospace for code or technical labels, say — reach for the mono cut of a family you're already using (many faces ship matched sans / serif / mono superfamilies) or a deliberately chosen companion, not an unrelated mono stapled on for "technical" flavor. A bolted-on mono that shares nothing with the primary face is a cohesion failure — and lately a trend tell: near-black canvas + a geometric grotesk + a mismatched mono is the "Vercel knockoff" look. Choose faces that form a system, not a pile.
Emotion Before Execution
Before any visual choice, the real question is: **wha
Read the complete source ↗