visual-design-foundations

Installation
SKILL.md

Visual Design Foundations

Concept of the skill

Visual design foundations is the discipline of shaping an interface's visual craft — palette, type, spacing rhythm, density, elevation, optical balance, hierarchy, contrast intent, motion feel, and brand fit — so that the surface's structure becomes legible rather than merely decorated. Its central premise is that visual design is not a coat of paint applied after the layout is done; it is the layer through which priority, grouping, affordance, and tone are made visible, so a user can scan and act without reading every label. The craft works through a small set of primitives chosen by role before raw value: palette roles (surface, text, accent, success/warning/danger/info, disabled) before specific colors, type roles (page title, section heading, control label, body, metadata, numeric emphasis) before specific sizes, spacing/density rules tuned to repeated real use rather than a single screenshot, and optical alignment that centers by perceived weight rather than only geometry — with elevation, border, and background reserved for clarifying grouping and affordance instead of adding noise. Crucially, it is a foundation skill by design: it gives the entry-level orientation across every craft dimension but explicitly hands off anything that needs the deep contract — formal color math (color-system-design), font-loading engineering and full type systems (typography-system), deep hierarchy modeling (visual-hierarchy), token governance (design-system-architecture / theme-system-design), sign-meaning analysis (semiotics), or accessibility compliance (a11y) — to the skill that owns it, and it cross-checks its decisions against semiotics and a11y before treating them as done.

Coverage

Design and audit visual craft for interface surfaces at foundation level. Covers:

  • Visual hierarchy — the ranked levers (size, weight, spacing/position, contrast, color) and how to spend the cheapest structural lever before reaching for color. Deep hierarchy modeling hands off to visual-hierarchy.
  • Palette direction — roles before raw colors, accent restraint, and the distinction between contrast intent (craft) and contrast compliance (a11y). Full palette construction and perceptual scale generation hand off to color-system-design.
  • Type direction — type roles, a single modular scale, and right-sizing type to the surface's density. The full type system (pairing, rhythm, font delivery) hands off to typography-system.
  • Spacing and rhythm — a consistent base unit (the 8-pt rhythm is the common default), spacing as a hierarchy and grouping tool, and density calibrated to repeated use.
  • Optical alignment and balance — centering icons, glyphs, badges, and control contents by perceived weight rather than bounding box, so the surface looks balanced at real production size.
  • Elevation and borders — tonal-first elevation with shadow as a selective separation/affordance tool, never blanket depth.
  • Motion feel — purposeful, short, direction-aware transitions that clarify state or continuity and degrade gracefully under reduced-motion. State-feedback patterns (loading, skeletons, errors, empty states) hand off to interaction-feedback.
  • Brand fit and tone — matching the visual register to the surface type and product purpose (see the surface-register matrix).
  • Handoff judgment — knowing when a concern should be split off to a deeper color, typography, hierarchy, theming, motion, sign-meaning, or accessibility skill.
Installs
10
First Seen
May 14, 2026
visual-design-foundations — jacob-balslev/skills