Generate a comprehensive web design reference sheet (docs/design/design-reference.md) and its companion enforcement skill (.agents/skills/{project-slug}/SKILL.md) for any website project. Extracts tokens from CSS files, validates completeness against a JSON schema scratchpad, inspects existing components, and produces a 12-section living document covering colours, typography, spacing, layout, borders, shadows, motion, component patterns, accessibility, dark mode, and Figma sync notes. Use when starting a new project, onboarding a design system, creating a Figma reference sheet, porting design tokens, or auditing existing styles. Triggers on: "create a design reference", "generate a style guide", "document the design tokens", "make a brand reference sheet", "create design docs", "port design tokens", "audit existing styles".
97
100%
Does it follow best practices?
Impact
89%
2.61xAverage score across 3 eval scenarios
Passed
No known issues
The elements of design are the fundamental visual building blocks — the raw vocabulary of any visual composition. Every design, from a logo to a webpage, is constructed from some combination of these elements.
A mark connecting two points; the most fundamental element.
Types:
Line weight: Thick lines feel heavy and bold; thin lines feel delicate and refined.
Implied lines — not drawn, but suggested by alignment of elements, eye gaze direction, or the edge of a shape. Strongly guide eye movement.
Design application: Horizontal rules, border separators, underlines, and grid lines are all lines. Diagonal photography compositions create energy. Text alignment creates implied lines that organise content.
A two-dimensional area defined by a boundary (a closed line, contrast, or colour).
Geometric shapes — circles, squares, triangles, polygons. Convey structure, order, logic.
Organic shapes — irregular, free-form, natural. Convey warmth, creativity, approachability.
Abstract shapes — simplified or stylised representations (icons, logos, pictograms).
Positive vs negative shape: The filled shape (positive) and the space around it (negative/white space) are equally important. Logos exploit figure-ground relationships.
Design application: Button shapes, card containers, avatar crops, hero section blobs, icon design — all are shape decisions. Rounded corners soften; sharp corners are more assertive.
Shape extended into three dimensions — or the illusion of three dimensions on a 2D surface.
Actual form — physical 3D objects (packaging, product design, signage).
Implied form — the illusion of depth and volume created through:
Design application: Drop shadows, box shadows, gradients, and depth layers (elevation system) all create implied form in flat UI design. Skeuomorphic design relies heavily on form to imply physicality.
The area within and around elements.
Positive space — the area occupied by subjects and content.
Negative space (white space) — the empty area around and between elements. Not absence — it is an active element that defines and supports the positive content.
Depth cues:
Design application: See whitespace-theory.md for detailed application guidance. In UI, the
space between a heading and its paragraph, between a card and its neighbours, and the padding
inside a button are all active space decisions.
The surface quality of an element — tactile or visual.
Actual texture — physically touchable (print, packaging, embossing, fabric).
Visual texture — the illusion of texture on screen:
Design application: Subtle noise overlays add warmth to flat colour backgrounds. Paper texture backgrounds evoke analogue craft. Avoiding texture creates the clean, digital aesthetic. Most modern web UI uses texture sparingly — a background grain, a subtle pattern.
The relative lightness or darkness of an element — independent of hue.
Value scale: Runs from pure white (lightest) through grey to pure black (darkest).
High contrast — strong differentiation between light and dark areas. Dramatic, bold, readable.
Low contrast — subtle tonal differences. Soft, refined, sophisticated — but can reduce readability.
Tint — a colour mixed with white (lighter value). Shade — a colour mixed with black (darker value). Tone — a colour mixed with grey (reduced saturation, adjusted value).
Design application: Value is the foundation of readability. Text must have sufficient value contrast against its background (WCAG contrast ratios are essentially value contrast ratios). Dark mode inverts the value hierarchy.
The visual property arising from the spectrum of light reflected or emitted. The most emotionally powerful element of design.
Colour properties:
Colour temperature:
Colour relationships (harmony): See psychology-of-color.md for full palette strategy.
Additive colour (RGB/screen) — red + green + blue = white. Used for all digital design.
Subtractive colour (CMYK/print) — cyan + magenta + yellow + black = black. Used for print.
Design application: Colour is never used in isolation — it is always experienced relative to surrounding colours. Establish a palette of primary, secondary, and neutral colours, then use them consistently through design tokens.
Typography is simultaneously a functional tool and a visual element with its own texture, rhythm, and personality.
Typeface categories:
The typographic elements:
Design application: See typography-principles.md for hierarchy, scale, and pairing guidance.
| Element | What it is | Key design consideration |
|---|---|---|
| Line | Mark connecting two points | Weight, direction, and implied lines |
| Shape | 2D enclosed area | Geometric = structured; organic = warm |
| Form | 3D or illusion of depth | Shadow, gradient, and elevation |
| Space | Area in/around elements | Negative space is an active design element |
| Texture | Surface quality | Visual texture via pattern/grain/noise |
| Value | Lightness/darkness | Foundation of contrast and readability |
| Colour | Hue + saturation + value | Most emotionally powerful element |
| Typography | Letterforms as visual elements | Texture, rhythm, and personality |