Design styles

SkillMedia

Applies a deliberate visual direction to an interface — minimalist editorial, industrial utilitarian, or high-polish commercial — each with its own type scale, palette behavior, surface treatment, and motion. Use this when a product needs a point of view rather than defaults, when choosing between visual directions, when an interface reads as generic, or when restyling something without changing its structure.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Design styles skill

What this skill tells your AI

The instructions your AI receives, as published by cbrock84/headcount in plugins/product/skills/design-styles/SKILL.md and read by ahel’s review.

Three directions, each internally consistent. Pick one deliberately and apply it completely — half-applied styles read as mistakes, not hybrids.

Choosing

DirectionReads asFits when
Minimalist editorialCalm, content-first, confidentThe content is the product: docs, writing tools, reading surfaces, analytics where data should dominate
Industrial utilitarianPrecise, dense, tool-likeThe user is an operator, not a visitor: developer tooling, dashboards, internal systems
High-polish commercialExpensive, considered, reassuringPerceived quality drives the decision: marketing surfaces, onboarding, anything asking for trust or money

If the brief does not imply one, ask. Defaulting is how products end up looking like their framework's starter template.

Minimalist editorial

Near-monochrome with a single accent used sparingly. Hierarchy carried almost entirely by type size and generous whitespace. Flat surfaces — no shadows, no gradients; separation by space and hairline rules. Wide margins. Motion is almost absent: fades, no movement.

Fails when: applied to dense data, where the whitespace it needs is not available.

Industrial utilitarian

Rigid grid, visible structure. Extreme type contrast — small dense body against large stark headings. Monospace for anything numeric or identifying. Functional color only: state, not decoration. Square or near-square corners, borders rather than shadows. Motion is instant or absent.

Fails when: applied to consumer surfaces, where it reads as unfinished rather than deliberate.

High-polish commercial

Layered depth — considered shadows at two or three elevations, never more. Generous but not empty spacing. A type pairing with real personality in headings against a neutral body. Restrained gradients on key surfaces only. Motion is present and eased: things enter and settle rather than appear.

Fails when: applied to high-frequency tools, where the motion and padding become friction.

Applying any of them

  1. Name the direction and why it fits this audience.
  2. Set tokens to match before writing markup — the style lives in the token values.
  3. Apply completely. A utilitarian grid with soft shadows is not a hybrid.
  4. Do not change layout structure to suit the style. If structure must change, that is a separate decision, stated as one.

Never

  • Mix two styles on one surface because each has a part you like. Pick one and hold it.
  • Choose a style before you know the content it has to carry and who is reading it.
  • Treat a style as decoration applied at the end. It decides density, spacing, and hierarchy from the first screen.
  • Copy a reference into a layout your real content cannot fill. Empty space that was supposed to hold something reads as broken.

Signals

GitHub stars
1k
Forks
209
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
design-styles
Source
github.com/cbrock84/headcount