Layout Principles
When to Use
Use this skill when:
- The user describes a layout that "feels off," "looks cluttered," "lacks focus," or "seems unbalanced" and needs a structured diagnostic with specific corrective measurements
- The user shares a design description, screenshot, wireframe, or spec and wants grid alignment verified against column counts, gutters, and margins
- The user asks how to distribute visual weight across a page -- improving hierarchy between headlines, subheads, body text, images, and CTAs
- The user wants to optimize white space between specific elements and needs exact pixel values, rem values, or ratio multipliers rather than subjective guidance
- The user wants to identify and strengthen the focal point of a design -- including applying rule of thirds, golden ratio, or eye-tracking pattern analysis
- The user is refining an existing design (not building from scratch) and needs to audit one or more layout principles: grid, hierarchy, spacing, balance, or focal point
- The user needs to explain to a developer or stakeholder exactly what layout changes are required, with measurements precise enough to implement directly
- The user asks about layout concepts in the abstract -- explaining proximity, alignment, repetition, contrast, enclosure, flow -- with practical application instructions
Do NOT use when:
- The user wants to wireframe a new page from scratch with no existing layout to evaluate -- use
wireframe-specification instead, which handles content structure and interaction flow
- The user wants to define responsive breakpoints, fluid grid behavior, or viewport-dependent layout changes -- use
responsive-layout-design instead, which handles breakpoint logic and content reflow
- The user's primary problem is font choice, type scale, line-height, or kerning -- use
typography-system instead, though this skill may reference type size as part of hierarchy analysis
- The user wants to build or choose a color system from scratch -- use
color-palette-design instead, though this skill uses color contrast ratios as part of hierarchy and focal point evaluation
- The user wants interaction design guidance (hover states, transitions, animation timing) -- layout principles apply to static states only
- The user is doing data visualization layout (chart types, axis placement, legend positioning) -- this requires a specialized data viz skill with different compositional rules
Process
Step 1 -- Gather Layout Context
Before any analysis, collect the minimum required information. If the user has not provided it, ask specifically:
- Current layout description: What elements exist and roughly where are they positioned? Accept screenshots, written descriptions, ASCII art, or component lists.
- Content type and medium: Marketing landing page, mobile app screen, print brochure, editorial article, dashboard, email template, presentation slide, or physical signage. Each has different baseline grid norms and viewing distance assumptions.
- Dimensions and constraints: Canvas size in pixels (digital) or millimeters (print). Fixed or fluid container? Any locked elements that cannot move?
- Problem symptom: What specifically feels wrong? Cluttered, unbalanced, no focal point, elements fighting for attention, sections blending together, feels flat, feels chaotic? The symptom identifies which principle to prioritize.
- Intended user goal: What should the viewer do or feel first? Buy, read, explore, understand data, be impressed? This sets the intended hierarchy.
- Existing grid system: Is the design using a known system (Bootstrap 12-col, Material Design 4-col, CSS Grid with named areas)? Or is it freeform?
If no information is provided at all, open with a set of diagnostic questions rather than making assumptions. Layout analysis without context produces generic advice, not a useful audit.
Step 2 -- Classify the Layout Type and Establish Baseline Grid Expectations
Different layout archetypes have different grid norms. Before auditing, identify which archetype applies:
Marketing / landing page
- Standard: 12-column grid, 1200px or 1440px max-width container
- Gutter: 24-32px between columns
- Margins: 80-120px left/right on desktop (or equivalent percentage: 6-8% each side)
- Hierarchy mode: Single dominant CTA on L1, everything else subordinate
- Scan pattern: Z-pattern (minimal text) or modified F-pattern (longer pages)
Editorial / article / long-form content
- Standard: 12-column grid, body text confined to 6-8 central columns (approximately 60-75 characters per line -- the optimal measure)
- Gutter: 24px
- Margins: Wide (the 4 outer columns become margin space, 30-35% of total width)
- Hierarchy mode: F-pattern reading. Pull quotes and images interrupt the vertical flow intentionally.
- Baseline grid: 8px base (line-height multiples snap to 8px increments)
Dashboard / data-dense UI
- Standard: Modular grid (columns + rows), 8-column or 12-column, 16-24px gutters
- Margins: 16-24px (space is constrained, margins compress)
- Hierarchy mode: Multiple focal points allowed -- one per panel. Use weight and color to differentiate, not size.
- Scan pattern: F-pattern for primary metrics (top row gets highest attention)
Card / gallery grid
- Standard: Modular grid, typically 2-4 columns depending on card complexity
- Gutters: Consistent across all cards (16-24px)
- Hierarchy: No single dominant element -- all cards are L2. Hero card (if present) spans 2 columns to create L1.
- White space: Outer gutter ≥ inner gutter (cards breathe more at the edge than between each other)
Presentation slide
- Standard: 1920×1080px (16:9) or 1280×720px
- Grid: 12-column or simple 3-column. No margins narrower than 80px.
- Hierarchy: Each slide should have ONE message as L1. Supporting visuals are L2. Everything else is L3 or omitted.
- Reading distance: 2-6 meters typical. Minimum body text 20-24px. Hierarchy gaps must be larger than on screens.
Print (A4/Letter/tabloid)
- Canvas: A4 = 210×297mm. US Letter = 215.9×279.4mm.
- Bleed: 3mm on all edges (content that extends to physical edge must bleed past it)
- Safe zone: 5mm inside trim line for critical content
- Grid: Typically 9-column or 12-column with smaller gutters (4.2mm for A4 single-page, 5mm for spreads)
- Points, not pixels: Typography in pt. 1pt = 0.353mm. Body text minimum 9pt. Display minimum 18pt.
Step 3 -- Audit Grid Alignment
Evaluate whether elements sit on the established grid. Work through each check systematically:
Column alignment checks:
- Do element left edges snap to column left edges or gutter right edges? No element should be offset by an arbitrary number. Every horizontal position should be explainable by the grid.
- Do element widths span whole column units (1 col, 2 cols, 3 cols) rather than fractional widths?
- Are there elements that need to span the full width for conceptual reasons (nav bars, dividers, hero backgrounds) that are correctly set to bleed or full-container width?
- Are gutters consistent? The space between column 1 and column 2 must equal the space between column 5 and column 6. Any inconsistency breaks the grid's reliability.
Margin checks:
- Left margin must equal right margin in symmetric layouts (the default). Asymmetric margins are intentional design choices and must serve a clear purpose.
- Top margin consistency: First element below the header must have the same top margin on every page/screen.
- Nested margin rule: When elements are inside a container (card, modal, panel), the inner padding forms a secondary grid. This inner padding must also be a multiple of the base unit.
Base unit discipline:
The most robust grids are based on a single base unit. For digital, 8px is the industry standard base unit. Every spacing value should be a multiple of 8: 8, 16, 24, 32, 40, 48, 56, 64, 80, 96. A 4px sub-unit is acceptable for micro-spacing (icon-to-label gaps, inline padding). Values like 13px, 22px, or 37px indicate a grid has not been applied -- flag each occurrence.
Identifying misalignment: When describing misalignment in the analysis, name the specific element and its deviation. "The pricing headline is offset 14px from the left column edge" is actionable. "Some elements are misaligned" is not.
Step 4 -- Audit Visual Hierarchy
Visual hierarchy is the deliberate arrangement of elements to create a ranked reading order. The goal is to ensure the viewer's eye moves through the content in the intended sequence.
The seven dimensions of visual weight (ranked by typical impact):
Size -- The single most powerful hierarchy tool. A 2:1 size ratio creates a clear dominant/subordinate relationship. A 3:1 ratio creates strong contrast. For type, a well-structured scale uses a type scale ratio of 1.25 (Major Third) to 1.618 (Golden Ratio). At 16px base: 1.25 scale yields 16, 20, 25, 31, 39px. 1.414 scale yields 16, 23, 32, 45, 64px.
Weight (boldness) -- Weight 700 reads as significantly heavier than weight 400 at the same size. Weight alone can shift an element from L2 to L1 when combined with size.
Color and contrast -- A high-contrast color (black on white: 21:1 contrast ratio) dominates a low-contrast color (gray #999 on white: 2.85:1). Saturated colors attract attention over desaturated. Warm colors (red, orange) attract over cool (blue, green) at equal saturation.
Position -- Above the fold dominates below. Top-left dominates in LTR reading cultures (F and Z pattern entry points). Center dominates for single-element compositions. Bottom-right is the weakest position -- use it for disclaimers and secondary navigation.
Isolation / white space -- An element surrounded by significantly more space than its neighbors gains visual weight. This is why a single word in a large empty area immediately becomes the focal point.
Texture and complexity -- Highly detailed, textured, or photographic elements attract the eye over flat, simple shapes. Use this intentionally: a complex hero image naturally draws the eye before flat text blocks.
Motion -- The most powerful attractor in digital contexts. Any moving element will capture attention before any static element at the same visual weight. Use motion only to direct attention to the most critical element.
Hierarchy tier definitions:
- L1 (Dominant): Exactly one element per page or screen. The first thing every viewer sees. Typically the primary headline or hero image.
- L2 (Supporting): 2-5 elements that provide context for L1. Section headings, feature icons, key statistics, the primary CTA.
- L3 (Content body): The main information mass. Body text, card content, list items.
- L4 (Recessive): Navigation, labels, metadata, footnotes, legal text. Should register but not compete.
Hierarchy failure modes to check for:
- No L1: Multiple elements at the same visual weight -- the eye has no entry point. Fix by increasing one element's size, weight, or contrast.
- Competing L1s: Two or more elements at L1 weight. Flag each and recommend which to demote.
- Collapsed hierarchy: Only two tiers exist (big and everything else). L2 and L3 elements blend together. Fix by introducing a middle tier through size or weight adjustments.
- Inverted hierarchy: A decorative element (background image, icon set) is visually heavier than the primary message. Reduce the decoration's visual weight (opacity, desaturation) or increase the message's weight.
Step 5 -- Audit White Space
White space is not emptiness -- it is the spatial relationship that groups related elements and separates unrelated ones. It communicates structure without visual elements.
The three-tier spacing system:
| Tier |
Name |
Function |
Digital Range |
Print Range |
| Micro |
Within-component |
Padding inside buttons, labels, cards; space between icon and text |
4-16px |
1-4mm |
| Meso |
Between-component |
Gap between cards, form fields, list items, inline elements |
16-48px |
4-12mm |
| Macro |
Between-section |
Separation between major page sections, content blocks |
48-128px |
12-30mm |
The inviolable spacing ratio rule:
Macro white space MUST be larger than meso white space, which MUST be larger than micro white space. Specifically:
- Meso ≥ 2× micro (if micro is 8px, meso minimum is 16px)
- Macro ≥ 2× meso (if meso is 24px, macro minimum is 48px)
- If these ratios are violated anywhere on the layout, elements will appear to belong to wrong groups.
Proximity principle application:
Elements with related meaning should have less space between them than elements from different groups. When auditing, group elements logically first, then verify that spatial proximity reflects that grouping. A label 8px above its input field but 24px above the next label creates correct proximity. A label 24px above both its input and the next label fails proximity -- the input does not appear to belong to the label.
White space failure modes:
- Crowding: Micro spacing applied at the macro level. Sections separated by only 16px merge visually. The fix is almost always to triple or quadruple the section gap.
- Floating: An element has so much macro space around it that it appears disconnected from the content it belongs to. Reduce the space on one side to create a proximity relationship.
- Inconsistent meso: Card 1 has a 24px bottom margin, card 2 has 16px. The grid appears broken even if column alignment is correct.
- Interior crowding: Content inside a container has inadequate padding. The minimum safe padding inside any container (card, modal, panel) is equal to the meso spacing value. If cards are separated by 24px (meso), their interior padding should be at least 24px.
Digital-specific note on 8px grid discipline:
All spacing values must be multiples of 8px. If the micro-spacing is 12px (not on the 8px grid), change it to 8px or 16px based on which looks better. The 4px sub-grid is acceptable only for optical adjustments to micro-spacing (such as 4px between an icon and its inline label).
Step 6 -- Audit Focal Point and Eye-Flow
The focal point is where the viewer's eye lands first. Eye-flow is the path the eye takes after that entry point. Both must be designed intentionally.
Focal point placement techniques:
Rule of thirds:
Divide the canvas into a 3×3 grid. The four intersection points (at 33%/67% horizontally and 33%/67% vertically) are the four strongest focal positions. The top-left intersection is the strongest in LTR cultures. For a 1200px wide canvas, intersections are at 400px and 800px horizontally, and at proportional vertical positions.
Golden ratio (φ = 1.618):
The golden ratio provides an alternative focal point placement. Divide the canvas width by 1.618 to find the primary focal zone boundary. On a 1200px canvas: 1200 ÷ 1.618 = 741px from the left. The focal content should be centered on or near this 741px mark. The golden ratio spiral, when overlaid, provides a flow path from the focal point outward.
Optical center:
The perceived center of a rectangle is approximately 10% above the geometric center. For a 900px tall canvas, the geometric center is 450px, but the optical center is approximately 405px. Placing the primary element at optical center rather than geometric center appears balanced; at geometric center it reads as slightly low.
Eye-tracking scan patterns:
Z-pattern: Used when text density is low and visuals dominate. The eye enters at top-left, sweeps to top-right, drops diagonally to bottom-left, then sweeps to bottom-right. Design the layout so L1 is at top-left (or top-center), the primary CTA is at top-right or bottom-right.
F-pattern: Used when text density is high (articles, list pages, search results). The eye makes a strong horizontal sweep across the top (catches headlines), a shorter horizontal sweep below (catches subheads), then drops straight down the left edge (scanning for lead words). Place the most important information at the top horizontal band or the left edge. Avoid placing CTAs in the right half of the lower content area -- eye-tracking studies show those positions have poor fixation rates.
Gutenberg diagram: For layouts with evenly distributed elements (not clearly left-to-right), the eye moves from the top-left "primary optical area" to the bottom-right "terminal area." The top-right and bottom-left areas are "fallow" -- low attention. Reserve fallow areas for supporting content, not key actions.
Circular flow: For single-screen or splash layouts with a centered composition, the eye moves clockwise from the dominant element. Support this by arranging supporting elements clockwise around the focal point.
Focal point failure modes:
- No clear focal point: Every element is sized and weighted similarly. Fix: increase L1's size by at least 2× relative to L2.
- Competing focal points: Two elements have similar visual weight at L1 level. Fix: demote one by reducing size (to 0.7× of L1), reducing contrast (lighten the color), or increasing surrounding content density to reduce its isolation.
- Focal point leads nowhere: The eye finds the focal point but has no logical path to the primary action. Fix: position the CTA below or to the right of the focal point, within the natural eye-flow path.
- Off-pattern focal point: The most important element is placed in a fallow zone (lower-right in an F-pattern layout, lower-left in a Z-pattern layout). Reposition to the appropriate high-attention zone.
Step 7 -- Assess Visual Balance
Balance is the distribution of visual weight across the layout's axes. Unlike hierarchy (which is about reading order), balance is about the overall sense of stability or dynamism.
Symmetric balance:
Equal visual weight on both sides of the central vertical axis. Creates stability, formality, and trust. Appropriate for corporate, financial, and healthcare layouts. Risk: can appear static or boring if hierarchy is not introduced through size and color.
Asymmetric balance:
Different elements on each side that have equivalent but not identical visual weight. A large, simple element on the right is balanced by a smaller, more complex cluster on the left. Creates dynamism and modernity. Requires careful weight calculation.
Visual weight calculation (approximate):
Assign relative weight values to major elements to check balance. A useful heuristic:
- Full-color photograph, 400×400px: weight 8
- Bold headline, 48px, full width: weight 6
- White space 200×400px area: weight 1
- Icon cluster 3× 32px: weight 2
- Body text paragraph 300×80px: weight 3
Sum the approximate weight on each side of the central axis. If the ratio exceeds 2:1, the layout will feel tilted. If it is between 1:1 and 1.5:1, it is balanced.
Radial balance:
Elements radiate from a central point. Rare in conventional layouts. Appropriate for certain infographic, icon cluster, or hero section treatments.
Balance assessment questions:
- Does the layout feel stable or does it feel like it wants to tip?
- Is any quadrant empty enough to feel like a void?
- Does the above-fold section feel heavier or lighter than below-fold?
Step 8 -- Generate Specific, Prioritized Recommendations
Each recommendation must follow this structure:
- Element: Name the specific element or group (e.g., "hero section headline," "pricing card row," "navigation bar")
- Current state: What is the current measurement or arrangement?
- Problem: Which principle is violated and why it matters
- Fix: The exact change with measurements (pixel values, column spans, ratio multipliers, opacity percentages)
- Expected outcome: What will visually improve as a result?
Prioritize recommendations in this order:
- Hierarchy violations (L1 is wrong or absent) -- these cause the most confusion
- Focal point misalignment -- affects immediate first impression
- Major white space violations (macro ≤ meso) -- causes sections to blur together
- Grid alignment failures -- undermines structural credibility
- Balance issues -- affects overall comfort
- Minor spacing inconsistencies -- polish-level fixes
Acknowledge what works well in the current layout before listing problems. This grounds the analysis and provides a baseline for comparison.
Output Format
## Layout Analysis: [Page or Screen Name]
### Context
- **Content type:** [marketing page / dashboard / editorial / card grid / etc.]
- **Dimensions:** [canvas dimensions in px or mm]
- **Grid system in use:** [12-column / modular / freeform / unknown]
- **Primary user goal:** [what the viewer should do or feel first]
---
### Overall Assessment
| Principle | Rating | Status | Key Finding |
|-------------------|--------|-------------|-----------------------------------------------------|
| Grid alignment | ★★★☆☆ | Needs work | [specific misalignment with element name] |
| Visual hierarchy | ★★☆☆☆ | Poor | [hierarchy failure type: no L1 / competing / etc.] |
| White space | ★★★★☆ | Good | [specific violation or "ratios maintained"] |
| Focal point | ★★☆☆☆ | Poor | [focal point issue with position] |
| Visual balance | ★★★☆☆ | Adequate | [balance issue or "balanced"] |
Rating key: ★★★★★ Excellent | ★★★★☆ Good | ★★★☆☆ Adequate | ★★☆☆☆ Poor | ★☆☆☆☆ Severe
---
### What Works Well
- [Element or principle that is handled correctly -- be specific]
- [Second thing that works well]
---
### Grid Analysis
- **Current grid:** [column count, gutter size, margin size -- or "no grid apparent"]
- **Base unit:** [8px / other -- or "not on a base unit grid"]
- **Recommended grid:** [column count at Xpx max-width, Ypx gutters, Zpx margins]
- **Misaligned elements:**
- [Element name]: [current position / offset] -- should align to [column/edge]
- [Element name]: [current position / offset] -- should align to [column/edge]
- **Grid fix:** [specific alignment adjustments with exact values]
---
### Hierarchy Analysis
- **Intended L1:** [what should be dominant based on user's goal]
- **Current L1:** [what the eye actually hits first and why]
- **Hierarchy tiers found:**
- L1: [element] at [size/weight/color]
- L2: [elements] at [size/weight/color]
- L3: [elements] at [size/weight/color]
- L4: [elements] at [size/weight/color]
- **Failure mode:** [none / no L1 / competing L1s / collapsed / inverted]
- **Hierarchy fix:**
- Increase [element] to [size]px, weight [value]
- Reduce [element] to [size]px, weight [value]
- Adjust [element] color to [contrast ratio target: e.g., 7:1 against background]
---
### White Space Analysis
| Tier | Location | Current Value | Target Value | Status |
|--------|-----------------------------------|---------------|--------------|-----------|
| Micro | [specific element, e.g. btn padding] | [X]px | [Y]px | [OK/Fix] |
| Micro | [specific element] | [X]px | [Y]px | [OK/Fix] |
| Meso | [specific element gap] | [X]px | [Y]px | [OK/Fix] |
| Meso | [specific element gap] | [X]px | [Y]px | [OK/Fix] |
| Macro | [section gap] | [X]px | [Y]px | [OK/Fix] |
| Macro | [section gap] | [X]px | [Y]px | [OK/Fix] |
- **Ratio status:** Macro:[meso ratio] / Meso:Micro ratio [X:1 -- target 2:1 minimum]
- **Proximity violations:** [elements grouped incorrectly by spacing]
- **White space fix:** [specific values to change]
---
### Focal Point Analysis
- **Recommended scan pattern:** [Z-pattern / F-pattern / Gutenberg / circular] -- rationale
- **Current focal point:** [element, position as % from top-left, e.g. "50% × 20%"]
- **Recommended focal point position:** [element should be at X% × Y%, technique used]
- **Eye-flow path:** [describe the intended L1 -> L2 -> CTA path]
- **Focal point failure:** [none / no focal point / competing / off-pattern / leads nowhere]
- **Focal point fix:**
- Move [element] to [position] (rule of thirds intersection at X:Y or golden ratio at Xpx)
- [Additional adjustments to support the eye-flow path]
---
### Balance Analysis
- **Balance type:** [symmetric / asymmetric / radial]
- **Left-right weight ratio:** [approximate, e.g. 1.3:1 -- acceptable / 2.4:1 -- needs adjustment]
- **Above/below fold weight distribution:** [heavy top / heavy bottom / balanced]
- **Balance fix:** [specific element weight adjustments]
---
### Prioritized Recommendations
| # | Element | Change | Principle | Exact Measurement | Impact |
|---|-----------------------------|-----------------------------------------|----------------|--------------------------------|--------|
| 1 | [element name] | [specific change] | [principle] | [px / ratio / %, exact value] | High |
| 2 | [element name] | [specific change] | [principle] | [px / ratio / %, exact value] | High |
| 3 | [element name] | [specific change] | [principle] | [px / ratio / %, exact value] | Medium |
| 4 | [element name] | [specific change] | [principle] | [px / ratio / %, exact value] | Medium |
| 5 | [element name] | [specific change] | [principle] | [px / ratio / %, exact value] | Low |
---
### Implementation Order
1. [First change -- fixes the most critical issue, enables other changes]
2. [Second change -- builds on first]
3. [Third change -- refines]
Rules
Every spacing value must be on the 8px base unit grid. Values of 8, 16, 24, 32, 40, 48, 56, 64, 80, 96px are valid. Values like 13px, 22px, or 37px indicate freeform spacing and must be corrected to the nearest 8px increment unless a 4px sub-grid is explicitly justified for micro-spacing.
There must be exactly one L1 element per page or per distinct viewport screen. If the layout is scrollable, each viewport-height section may have one L1, but the overall page-level L1 (the above-the-fold dominant element) takes precedence. Multiple competing L1s are always a hierarchy failure, not a "balanced design choice."
Macro spacing must be at minimum 2× meso spacing, and meso must be at minimum 2× micro spacing. If a layout has 24px section gaps (macro) and 16px component gaps (meso), that is a violation -- both numbers are too close. Flag it and provide corrected values.
Never make a recommendation without a specific, measurable value. "Add more breathing room" is not valid. "Increase the gap between the testimonials section and the pricing section from 32px to 80px" is valid. Every recommendation must be precise enough for a developer to implement without judgment.
Always identify the intended scan pattern before evaluating focal point placement. A focal point is only "wrong" relative to the expected scan pattern for that content type. A Z-pattern landing page with a focal point at lower-left is misplaced. An F-pattern article with a focal point at lower-left may be correct for a pull-quote anchor.
Grid recommendations must include three values: column count, gutter size, and margin size. Recommending "a 12-column grid" is incomplete. The full recommendation is "12-column grid, 24px gutters, 80px margins, 1200px max-width container." All four parameters must be specified.
Do not pathologize intentional asymmetry. If a layout is intentionally grid-breaking (creative portfolio, editorial feature, artistic campaign), evaluate whether the breaks are consistent and purposeful. An intentional rule break that is applied consistently is a design choice. A sporadic misalignment is an error. Ask the user to clarify intent when unsure.
Contrast ratios for text must meet minimum thresholds. For hierarchy evaluation, note that text elements failing WCAG 2.1 AA contrast (4.5:1 for normal text, 3:1 for large text ≥ 18pt / 14pt bold) cannot function as hierarchy anchors regardless of their size, because they are illegible at distance. Flag contrast failures separately from hierarchy issues.
Acknowledge what is working before listing failures. A layout analysis that lists only problems is incomplete. Identify at least two elements or areas where the current layout succeeds. This gives the designer reference points to maintain while making changes.
Print and digital layouts use different unit systems and must not be mixed. Digital recommendations in pixels or rem. Print recommendations in millimeters or points. If a hybrid situation exists (designing a digital-first asset that will also print), specify both unit systems explicitly and note where they diverge.
Recommendations must be ordered by visual impact, not ease of implementation. The change that most improves the layout comes first even if it is harder to implement. The user can choose to skip difficult changes -- that is their decision -- but the priority order must reflect actual impact.
Do not assume a grid exists unless evidence of one is provided. If the user describes a layout without specifying a grid system, state "no grid apparent" and recommend one rather than analyzing against a grid that may not exist.
Edge Cases
No Existing Layout -- User Wants Principles Applied from Scratch
If the user has content but no layout, this skill becomes a layout blueprint mode rather than an audit mode. Define the appropriate grid for their content type and dimensions, assign hierarchy tiers to each content element they list (matching intended reading order to visual weight recommendations), specify all three tiers of white space, and identify which scan pattern to design for. Output a Layout Blueprint rather than a Layout Analysis. Note that for a full wireframe with interaction annotations, the user should proceed to wireframe-specification after receiving the blueprint.
Data-Dense Dashboard or Admin Panel
Standard white space ratios compress significantly. Micro: 4-8px (use 4px base unit instead of 8px for these layouts). Meso: 8-16px. Macro: 24-40px. The 2:1 ratio rule still applies -- maintain relative proportion even though absolute values are smaller. Hierarchy shifts from size-dominant to color-and-weight-dominant because vertical space is limited and multiple panels have equivalent importance. Multiple L1 focal points are acceptable when each is contained within a visually enclosed panel (a card with a border or background fill that creates enclosure). F-pattern applies: top row of metrics receives the most attention. Place the most critical KPIs in the first row, leftmost position.
Single-Element or Hero-Only Layouts (Splash Screens, Covers, Billboards)
The single element IS the focal point by definition -- the analysis shifts entirely to evaluating placement, white space ratio, and relationship to the frame. Target content-to-white-space ratio: 25-40% content, 60-75% white space for maximum impact (tight content-to-frame ratios feel suffocating on splash screens). Evaluate the element's position against rule of thirds (preferred) or optical center. Check whether the element is sized proportionally to the frame -- the element should not exceed 60% of the shorter canvas dimension. For billboard/OOH signage viewed at 30+ meters: minimum stroke weight 4pt equivalent, high contrast required (minimum 5:1 at full resolution), and the focal element should occupy 40-60% of the frame to remain readable at distance.
Print Layout with Bleed and Safe Zones
Three boundaries must be defined: bleed edge (design extends 3mm past trim), trim line (physical cut line), safe zone (5mm inside trim -- no critical content outside this boundary). Text that crosses the trim line must be justified by design intent, not accident. Evaluate hierarchy in terms of above-fold defined as the top half of the printed page (the upper half receives significantly more attention when print is displayed on a shelf or folded). Baseline grid is critical in print: use a consistent leading value (e.g., 12pt leading) and snap all text blocks to multiples of this leading value for cross-column alignment.
Intentionally Rule-Breaking Creative Layouts (Editorial, Portfolio, Campaign)
Do not apply standard grid audit rules mechanically. Instead, evaluate whether the rule-breaking is: (a) consistent -- the same rule is broken in the same way throughout, creating a system; (b) purposeful -- the break creates tension, movement, or emphasis that serves the design intent; (c) controlled -- the breaks are surrounded by structure that provides a reference point for the eye. An intentional break only reads as intentional if at least 60% of the layout is conventionally structured. If everything is breaking rules, nothing feels like a rule break -- it just looks chaotic. Recommend introducing at least one consistent structural anchor (a persistent margin, a baseline grid, a repeated element size) to make the rule-breaking legible as intentional.
Mixed-Medium Layouts (Web Page That Also Prints)
CSS print stylesheets address some issues, but layout principles must be evaluated for both contexts separately. In digital mode: fluid behavior, scrolling, interaction states. In print mode: fixed canvas, no scroll, bleed/safe zone rules apply. Document both assessments. Key differences: digital macro spacing (64-96px) will appear as vast empty space in print (20-30mm equivalent); reduce proportionally. Typography that is 16px on screen may be 12pt in print -- verify both are readable in their respective contexts. Color mode shift (RGB to CMYK) can change contrast ratios; flag any text/background combinations where CMYK shift might drop below 4.5:1.
Responsive Layout -- Multiple Breakpoints in Scope
This skill applies to single-viewport static layout analysis only. If the user needs to evaluate layout across breakpoints, the evaluation should be run separately for each major breakpoint (desktop 1440px, tablet 768px, mobile 375px). Common issues at breakpoints: hierarchy inversions (what is L1 at desktop becomes L3 when columns stack on mobile); white space ratio collapses (macro spacing set in px becomes disproportionately large on small screens -- prefer rem or viewport-relative units); grid collapses that create unintended focal point shifts. For full responsive layout design guidance, refer the user to responsive-layout-design.
User Provides Only a Problem Description with No Visual Reference
When no visual is provided, the analysis must be structured as a diagnostic interview + conditional recommendation. Ask targeted questions: what is the canvas size? How many major sections? What is the approximate column count being used? What is the approximate size of the headline versus body text? Is there a clear hero/focal element? Use the answers to construct the most likely layout state and produce a conditional analysis ("If your section gaps are approximately 24-32px, the macro/meso ratio is likely violated -- here is the fix"). Explicitly label all assumptions and invite correction. Do not produce a high-confidence analysis from a vague description.
Example
Input: "I have a SaaS product landing page. The layout from top to bottom is: navigation bar, hero section with a headline and subtext and a button, a 'social proof' bar with five logo images, a three-column features section with icon/title/text in each column, a testimonials section with three testimonial cards, a pricing section with three pricing tiers, and a footer. The page is 1440px wide. It looks too flat and nothing stands out. Every section feels the same importance and the CTA button in the hero barely registers."
Output:
Layout Analysis: SaaS Product Landing Page
Context
- Content type: Marketing / SaaS landing page
- Dimensions: 1440px wide, full-length scrollable
- Grid system in use: Unknown -- 12-column assumed based on three-equal-column feature section
- Primary user goal: Visitor should immediately understand the product value, then click the hero CTA to start a trial or learn more
Overall Assessment
| Principle |
Rating |
Status |
Key Finding |
| Grid alignment |
★★★☆☆ |
Adequate |
Assumed 12-col grid may be in use, but no confirmation; verify |
| Visual hierarchy |
★★☆☆☆ |
Poor |
No L1 established -- every section has equivalent visual weight |
| White space |
★★☆☆☆ |
Poor |
Likely macro = meso violation causing sections to blur together |
| Focal point |
★★☆☆☆ |
Poor |
Hero CTA is visually weak; no dominant focal entry point |
| Visual balance |
★★★☆☆ |
Adequate |
Three-column structures are likely balanced; hero unclear |
What Works Well
- The three-column feature section (icon / title / text) and three-card testimonials section are a structurally sound modular grid approach -- this creates good horizontal rhythm and reduces the amount of work needed in those sections.
- A clear sequential narrative exists in the content order (hero -> proof -> features -> social validation -> pricing -> conversion) -- the content strategy is sound. The layout problem is execution, not structure.
Grid Analysis
- Current grid: Likely 12-column based on three equal-column sections. Gutter and margin widths unknown. Assumed: 24px gutters, 120px margins.
- Base unit: Unknown -- recommend establishing 8px as base unit throughout
- Recommended grid: 12-column at 1200px max-width container (centered in 1440px canvas), 24px gutters, 120px left/right margins (8.3% of 1440px). This centers the content comfortably and leaves sufficient breathing room on the 1440px canvas.
- Misaligned elements (probable):
- Social proof logos: If centered within the full 1440px canvas without snapping to the 12-column grid, logos will float inconsistently. Align the logo row to a 6-column centered span (columns 4-9 of 12).
- CTA button in hero: Likely left-aligned with the headline but not constrained to a maximum width. Set the button width to auto with horizontal padding of 32px each side, ensuring it does not exceed 240px width.
- Grid fix: Establish the 1200px max-width container explicitly. All section content (text blocks, cards, feature columns) should be constrained to this 1200px grid. Section backgrounds (full-bleed color bands or images) may span the full 1440px canvas width.
Hierarchy Analysis
Intended L1: Hero section headline -- this is the primary value proposition and the first message the visitor should receive
Current L1: Likely nothing -- the hero headline, section headings, and testimonial headings are probably at similar visual weights, creating the "everything feels the same" symptom described
Hierarchy tiers as they likely exist:
- L1: No clear element (hero image or headline shares weight with section headings)
- L2: Section headings, feature titles, testimonial cards -- all at similar size
- L3: Body text, testimonial text, pricing descriptions
- L4: Nav links, footer links, social proof labels
Failure mode: No L1 established -- multiple elements competing for the same visual tier
Hierarchy fix:
…(truncated)
1---2name: layout-principles3description: Produces layout analysis and recommendations using grid alignment, visual hierarchy rules, white space ratios, and focal point placement with specific measurements and ratios. Use when the user asks to improve a layout, apply layout principles, fix spacing issues, evaluate grid alignment, or optimize visual balance in a design. Do NOT use for wireframing from scratch (use wireframe-specification), responsive breakpoint design (use responsive-layout-design), or typography-specific issues (use typography-system).4license: Apache-2.05---6# Layout Principles78## When to Use910**Use this skill when:**11- The user describes a layout that "feels off," "looks cluttered," "lacks focus," or "seems unbalanced" and needs a structured diagnostic with specific corrective measurements12- The user shares a design description, screenshot, wireframe, or spec and wants grid alignment verified against column counts, gutters, and margins13- The user asks how to distribute visual weight across a page -- improving hierarchy between headlines, subheads, body text, images, and CTAs14- The user wants to optimize white space between specific elements and needs exact pixel values, rem values, or ratio multipliers rather than subjective guidance15- The user wants to identify and strengthen the focal point of a design -- including applying rule of thirds, golden ratio, or eye-tracking pattern analysis16- The user is refining an existing design (not building from scratch) and needs to audit one or more layout principles: grid, hierarchy, spacing, balance, or focal point17- The user needs to explain to a developer or stakeholder exactly what layout changes are required, with measurements precise enough to implement directly18- The user asks about layout concepts in the abstract -- explaining proximity, alignment, repetition, contrast, enclosure, flow -- with practical application instructions1920**Do NOT use when:**21- The user wants to wireframe a new page from scratch with no existing layout to evaluate -- use `wireframe-specification` instead, which handles content structure and interaction flow22- The user wants to define responsive breakpoints, fluid grid behavior, or viewport-dependent layout changes -- use `responsive-layout-design` instead, which handles breakpoint logic and content reflow23- The user's primary problem is font choice, type scale, line-height, or kerning -- use `typography-system` instead, though this skill may reference type size as part of hierarchy analysis24- The user wants to build or choose a color system from scratch -- use `color-palette-design` instead, though this skill uses color contrast ratios as part of hierarchy and focal point evaluation25- The user wants interaction design guidance (hover states, transitions, animation timing) -- layout principles apply to static states only26- The user is doing data visualization layout (chart types, axis placement, legend positioning) -- this requires a specialized data viz skill with different compositional rules2728---2930## Process3132### Step 1 -- Gather Layout Context3334Before any analysis, collect the minimum required information. If the user has not provided it, ask specifically:3536- **Current layout description:** What elements exist and roughly where are they positioned? Accept screenshots, written descriptions, ASCII art, or component lists.37- **Content type and medium:** Marketing landing page, mobile app screen, print brochure, editorial article, dashboard, email template, presentation slide, or physical signage. Each has different baseline grid norms and viewing distance assumptions.38- **Dimensions and constraints:** Canvas size in pixels (digital) or millimeters (print). Fixed or fluid container? Any locked elements that cannot move?39- **Problem symptom:** What specifically feels wrong? Cluttered, unbalanced, no focal point, elements fighting for attention, sections blending together, feels flat, feels chaotic? The symptom identifies which principle to prioritize.40- **Intended user goal:** What should the viewer do or feel first? Buy, read, explore, understand data, be impressed? This sets the intended hierarchy.41- **Existing grid system:** Is the design using a known system (Bootstrap 12-col, Material Design 4-col, CSS Grid with named areas)? Or is it freeform?4243If no information is provided at all, open with a set of diagnostic questions rather than making assumptions. Layout analysis without context produces generic advice, not a useful audit.4445---4647### Step 2 -- Classify the Layout Type and Establish Baseline Grid Expectations4849Different layout archetypes have different grid norms. Before auditing, identify which archetype applies:5051**Marketing / landing page**52- Standard: 12-column grid, 1200px or 1440px max-width container53- Gutter: 24-32px between columns54- Margins: 80-120px left/right on desktop (or equivalent percentage: 6-8% each side)55- Hierarchy mode: Single dominant CTA on L1, everything else subordinate56- Scan pattern: Z-pattern (minimal text) or modified F-pattern (longer pages)5758**Editorial / article / long-form content**59- Standard: 12-column grid, body text confined to 6-8 central columns (approximately 60-75 characters per line -- the optimal measure)60- Gutter: 24px61- Margins: Wide (the 4 outer columns become margin space, 30-35% of total width)62- Hierarchy mode: F-pattern reading. Pull quotes and images interrupt the vertical flow intentionally.63- Baseline grid: 8px base (line-height multiples snap to 8px increments)6465**Dashboard / data-dense UI**66- Standard: Modular grid (columns + rows), 8-column or 12-column, 16-24px gutters67- Margins: 16-24px (space is constrained, margins compress)68- Hierarchy mode: Multiple focal points allowed -- one per panel. Use weight and color to differentiate, not size.69- Scan pattern: F-pattern for primary metrics (top row gets highest attention)7071**Card / gallery grid**72- Standard: Modular grid, typically 2-4 columns depending on card complexity73- Gutters: Consistent across all cards (16-24px)74- Hierarchy: No single dominant element -- all cards are L2. Hero card (if present) spans 2 columns to create L1.75- White space: Outer gutter ≥ inner gutter (cards breathe more at the edge than between each other)7677**Presentation slide**78- Standard: 1920×1080px (16:9) or 1280×720px79- Grid: 12-column or simple 3-column. No margins narrower than 80px.80- Hierarchy: Each slide should have ONE message as L1. Supporting visuals are L2. Everything else is L3 or omitted.81- Reading distance: 2-6 meters typical. Minimum body text 20-24px. Hierarchy gaps must be larger than on screens.8283**Print (A4/Letter/tabloid)**84- Canvas: A4 = 210×297mm. US Letter = 215.9×279.4mm.85- Bleed: 3mm on all edges (content that extends to physical edge must bleed past it)86- Safe zone: 5mm inside trim line for critical content87- Grid: Typically 9-column or 12-column with smaller gutters (4.2mm for A4 single-page, 5mm for spreads)88- Points, not pixels: Typography in pt. 1pt = 0.353mm. Body text minimum 9pt. Display minimum 18pt.8990---9192### Step 3 -- Audit Grid Alignment9394Evaluate whether elements sit on the established grid. Work through each check systematically:9596**Column alignment checks:**97- Do element left edges snap to column left edges or gutter right edges? No element should be offset by an arbitrary number. Every horizontal position should be explainable by the grid.98- Do element widths span whole column units (1 col, 2 cols, 3 cols) rather than fractional widths?99- Are there elements that need to span the full width for conceptual reasons (nav bars, dividers, hero backgrounds) that are correctly set to bleed or full-container width?100- Are gutters consistent? The space between column 1 and column 2 must equal the space between column 5 and column 6. Any inconsistency breaks the grid's reliability.101102**Margin checks:**103- Left margin must equal right margin in symmetric layouts (the default). Asymmetric margins are intentional design choices and must serve a clear purpose.104- Top margin consistency: First element below the header must have the same top margin on every page/screen.105- Nested margin rule: When elements are inside a container (card, modal, panel), the inner padding forms a secondary grid. This inner padding must also be a multiple of the base unit.106107**Base unit discipline:**108The most robust grids are based on a single base unit. For digital, 8px is the industry standard base unit. Every spacing value should be a multiple of 8: 8, 16, 24, 32, 40, 48, 56, 64, 80, 96. A 4px sub-unit is acceptable for micro-spacing (icon-to-label gaps, inline padding). Values like 13px, 22px, or 37px indicate a grid has not been applied -- flag each occurrence.109110**Identifying misalignment:** When describing misalignment in the analysis, name the specific element and its deviation. "The pricing headline is offset 14px from the left column edge" is actionable. "Some elements are misaligned" is not.111112---113114### Step 4 -- Audit Visual Hierarchy115116Visual hierarchy is the deliberate arrangement of elements to create a ranked reading order. The goal is to ensure the viewer's eye moves through the content in the intended sequence.117118**The seven dimensions of visual weight (ranked by typical impact):**1191201. **Size** -- The single most powerful hierarchy tool. A 2:1 size ratio creates a clear dominant/subordinate relationship. A 3:1 ratio creates strong contrast. For type, a well-structured scale uses a type scale ratio of 1.25 (Major Third) to 1.618 (Golden Ratio). At 16px base: 1.25 scale yields 16, 20, 25, 31, 39px. 1.414 scale yields 16, 23, 32, 45, 64px.1211222. **Weight (boldness)** -- Weight 700 reads as significantly heavier than weight 400 at the same size. Weight alone can shift an element from L2 to L1 when combined with size.1231243. **Color and contrast** -- A high-contrast color (black on white: 21:1 contrast ratio) dominates a low-contrast color (gray #999 on white: 2.85:1). Saturated colors attract attention over desaturated. Warm colors (red, orange) attract over cool (blue, green) at equal saturation.1251264. **Position** -- Above the fold dominates below. Top-left dominates in LTR reading cultures (F and Z pattern entry points). Center dominates for single-element compositions. Bottom-right is the weakest position -- use it for disclaimers and secondary navigation.1271285. **Isolation / white space** -- An element surrounded by significantly more space than its neighbors gains visual weight. This is why a single word in a large empty area immediately becomes the focal point.1291306. **Texture and complexity** -- Highly detailed, textured, or photographic elements attract the eye over flat, simple shapes. Use this intentionally: a complex hero image naturally draws the eye before flat text blocks.1311327. **Motion** -- The most powerful attractor in digital contexts. Any moving element will capture attention before any static element at the same visual weight. Use motion only to direct attention to the most critical element.133134**Hierarchy tier definitions:**135- **L1 (Dominant):** Exactly one element per page or screen. The first thing every viewer sees. Typically the primary headline or hero image.136- **L2 (Supporting):** 2-5 elements that provide context for L1. Section headings, feature icons, key statistics, the primary CTA.137- **L3 (Content body):** The main information mass. Body text, card content, list items.138- **L4 (Recessive):** Navigation, labels, metadata, footnotes, legal text. Should register but not compete.139140**Hierarchy failure modes to check for:**141- **No L1:** Multiple elements at the same visual weight -- the eye has no entry point. Fix by increasing one element's size, weight, or contrast.142- **Competing L1s:** Two or more elements at L1 weight. Flag each and recommend which to demote.143- **Collapsed hierarchy:** Only two tiers exist (big and everything else). L2 and L3 elements blend together. Fix by introducing a middle tier through size or weight adjustments.144- **Inverted hierarchy:** A decorative element (background image, icon set) is visually heavier than the primary message. Reduce the decoration's visual weight (opacity, desaturation) or increase the message's weight.145146---147148### Step 5 -- Audit White Space149150White space is not emptiness -- it is the spatial relationship that groups related elements and separates unrelated ones. It communicates structure without visual elements.151152**The three-tier spacing system:**153154| Tier | Name | Function | Digital Range | Print Range |155|------|------|----------|---------------|-------------|156| Micro | Within-component | Padding inside buttons, labels, cards; space between icon and text | 4-16px | 1-4mm |157| Meso | Between-component | Gap between cards, form fields, list items, inline elements | 16-48px | 4-12mm |158| Macro | Between-section | Separation between major page sections, content blocks | 48-128px | 12-30mm |159160**The inviolable spacing ratio rule:**161Macro white space MUST be larger than meso white space, which MUST be larger than micro white space. Specifically:162- Meso ≥ 2× micro (if micro is 8px, meso minimum is 16px)163- Macro ≥ 2× meso (if meso is 24px, macro minimum is 48px)164- If these ratios are violated anywhere on the layout, elements will appear to belong to wrong groups.165166**Proximity principle application:**167Elements with related meaning should have less space between them than elements from different groups. When auditing, group elements logically first, then verify that spatial proximity reflects that grouping. A label 8px above its input field but 24px above the next label creates correct proximity. A label 24px above both its input and the next label fails proximity -- the input does not appear to belong to the label.168169**White space failure modes:**170171- **Crowding:** Micro spacing applied at the macro level. Sections separated by only 16px merge visually. The fix is almost always to triple or quadruple the section gap.172- **Floating:** An element has so much macro space around it that it appears disconnected from the content it belongs to. Reduce the space on one side to create a proximity relationship.173- **Inconsistent meso:** Card 1 has a 24px bottom margin, card 2 has 16px. The grid appears broken even if column alignment is correct.174- **Interior crowding:** Content inside a container has inadequate padding. The minimum safe padding inside any container (card, modal, panel) is equal to the meso spacing value. If cards are separated by 24px (meso), their interior padding should be at least 24px.175176**Digital-specific note on 8px grid discipline:**177All spacing values must be multiples of 8px. If the micro-spacing is 12px (not on the 8px grid), change it to 8px or 16px based on which looks better. The 4px sub-grid is acceptable only for optical adjustments to micro-spacing (such as 4px between an icon and its inline label).178179---180181### Step 6 -- Audit Focal Point and Eye-Flow182183The focal point is where the viewer's eye lands first. Eye-flow is the path the eye takes after that entry point. Both must be designed intentionally.184185**Focal point placement techniques:**186187**Rule of thirds:**188Divide the canvas into a 3×3 grid. The four intersection points (at 33%/67% horizontally and 33%/67% vertically) are the four strongest focal positions. The top-left intersection is the strongest in LTR cultures. For a 1200px wide canvas, intersections are at 400px and 800px horizontally, and at proportional vertical positions.189190**Golden ratio (φ = 1.618):**191The golden ratio provides an alternative focal point placement. Divide the canvas width by 1.618 to find the primary focal zone boundary. On a 1200px canvas: 1200 ÷ 1.618 = 741px from the left. The focal content should be centered on or near this 741px mark. The golden ratio spiral, when overlaid, provides a flow path from the focal point outward.192193**Optical center:**194The perceived center of a rectangle is approximately 10% above the geometric center. For a 900px tall canvas, the geometric center is 450px, but the optical center is approximately 405px. Placing the primary element at optical center rather than geometric center appears balanced; at geometric center it reads as slightly low.195196**Eye-tracking scan patterns:**197198*Z-pattern:* Used when text density is low and visuals dominate. The eye enters at top-left, sweeps to top-right, drops diagonally to bottom-left, then sweeps to bottom-right. Design the layout so L1 is at top-left (or top-center), the primary CTA is at top-right or bottom-right.199200*F-pattern:* Used when text density is high (articles, list pages, search results). The eye makes a strong horizontal sweep across the top (catches headlines), a shorter horizontal sweep below (catches subheads), then drops straight down the left edge (scanning for lead words). Place the most important information at the top horizontal band or the left edge. Avoid placing CTAs in the right half of the lower content area -- eye-tracking studies show those positions have poor fixation rates.201202*Gutenberg diagram:* For layouts with evenly distributed elements (not clearly left-to-right), the eye moves from the top-left "primary optical area" to the bottom-right "terminal area." The top-right and bottom-left areas are "fallow" -- low attention. Reserve fallow areas for supporting content, not key actions.203204*Circular flow:* For single-screen or splash layouts with a centered composition, the eye moves clockwise from the dominant element. Support this by arranging supporting elements clockwise around the focal point.205206**Focal point failure modes:**207- **No clear focal point:** Every element is sized and weighted similarly. Fix: increase L1's size by at least 2× relative to L2.208- **Competing focal points:** Two elements have similar visual weight at L1 level. Fix: demote one by reducing size (to 0.7× of L1), reducing contrast (lighten the color), or increasing surrounding content density to reduce its isolation.209- **Focal point leads nowhere:** The eye finds the focal point but has no logical path to the primary action. Fix: position the CTA below or to the right of the focal point, within the natural eye-flow path.210- **Off-pattern focal point:** The most important element is placed in a fallow zone (lower-right in an F-pattern layout, lower-left in a Z-pattern layout). Reposition to the appropriate high-attention zone.211212---213214### Step 7 -- Assess Visual Balance215216Balance is the distribution of visual weight across the layout's axes. Unlike hierarchy (which is about reading order), balance is about the overall sense of stability or dynamism.217218**Symmetric balance:**219Equal visual weight on both sides of the central vertical axis. Creates stability, formality, and trust. Appropriate for corporate, financial, and healthcare layouts. Risk: can appear static or boring if hierarchy is not introduced through size and color.220221**Asymmetric balance:**222Different elements on each side that have equivalent but not identical visual weight. A large, simple element on the right is balanced by a smaller, more complex cluster on the left. Creates dynamism and modernity. Requires careful weight calculation.223224**Visual weight calculation (approximate):**225Assign relative weight values to major elements to check balance. A useful heuristic:226- Full-color photograph, 400×400px: weight 8227- Bold headline, 48px, full width: weight 6228- White space 200×400px area: weight 1229- Icon cluster 3× 32px: weight 2230- Body text paragraph 300×80px: weight 3231232Sum the approximate weight on each side of the central axis. If the ratio exceeds 2:1, the layout will feel tilted. If it is between 1:1 and 1.5:1, it is balanced.233234**Radial balance:**235Elements radiate from a central point. Rare in conventional layouts. Appropriate for certain infographic, icon cluster, or hero section treatments.236237**Balance assessment questions:**238- Does the layout feel stable or does it feel like it wants to tip?239- Is any quadrant empty enough to feel like a void?240- Does the above-fold section feel heavier or lighter than below-fold?241242---243244### Step 8 -- Generate Specific, Prioritized Recommendations245246Each recommendation must follow this structure:2472481. **Element:** Name the specific element or group (e.g., "hero section headline," "pricing card row," "navigation bar")2492. **Current state:** What is the current measurement or arrangement?2503. **Problem:** Which principle is violated and why it matters2514. **Fix:** The exact change with measurements (pixel values, column spans, ratio multipliers, opacity percentages)2525. **Expected outcome:** What will visually improve as a result?253254Prioritize recommendations in this order:2551. Hierarchy violations (L1 is wrong or absent) -- these cause the most confusion2562. Focal point misalignment -- affects immediate first impression2573. Major white space violations (macro ≤ meso) -- causes sections to blur together2584. Grid alignment failures -- undermines structural credibility2595. Balance issues -- affects overall comfort2606. Minor spacing inconsistencies -- polish-level fixes261262Acknowledge what works well in the current layout before listing problems. This grounds the analysis and provides a baseline for comparison.263264---265266## Output Format267268```269## Layout Analysis: [Page or Screen Name]270271### Context272- **Content type:** [marketing page / dashboard / editorial / card grid / etc.]273- **Dimensions:** [canvas dimensions in px or mm]274- **Grid system in use:** [12-column / modular / freeform / unknown]275- **Primary user goal:** [what the viewer should do or feel first]276277---278279### Overall Assessment280| Principle | Rating | Status | Key Finding |281|-------------------|--------|-------------|-----------------------------------------------------|282| Grid alignment | ★★★☆☆ | Needs work | [specific misalignment with element name] |283| Visual hierarchy | ★★☆☆☆ | Poor | [hierarchy failure type: no L1 / competing / etc.] |284| White space | ★★★★☆ | Good | [specific violation or "ratios maintained"] |285| Focal point | ★★☆☆☆ | Poor | [focal point issue with position] |286| Visual balance | ★★★☆☆ | Adequate | [balance issue or "balanced"] |287288Rating key: ★★★★★ Excellent | ★★★★☆ Good | ★★★☆☆ Adequate | ★★☆☆☆ Poor | ★☆☆☆☆ Severe289290---291292### What Works Well293- [Element or principle that is handled correctly -- be specific]294- [Second thing that works well]295296---297298### Grid Analysis299- **Current grid:** [column count, gutter size, margin size -- or "no grid apparent"]300- **Base unit:** [8px / other -- or "not on a base unit grid"]301- **Recommended grid:** [column count at Xpx max-width, Ypx gutters, Zpx margins]302- **Misaligned elements:**303 - [Element name]: [current position / offset] -- should align to [column/edge]304 - [Element name]: [current position / offset] -- should align to [column/edge]305- **Grid fix:** [specific alignment adjustments with exact values]306307---308309### Hierarchy Analysis310- **Intended L1:** [what should be dominant based on user's goal]311- **Current L1:** [what the eye actually hits first and why]312- **Hierarchy tiers found:**313 - L1: [element] at [size/weight/color]314 - L2: [elements] at [size/weight/color]315 - L3: [elements] at [size/weight/color]316 - L4: [elements] at [size/weight/color]317- **Failure mode:** [none / no L1 / competing L1s / collapsed / inverted]318- **Hierarchy fix:**319 - Increase [element] to [size]px, weight [value]320 - Reduce [element] to [size]px, weight [value]321 - Adjust [element] color to [contrast ratio target: e.g., 7:1 against background]322323---324325### White Space Analysis326| Tier | Location | Current Value | Target Value | Status |327|--------|-----------------------------------|---------------|--------------|-----------|328| Micro | [specific element, e.g. btn padding] | [X]px | [Y]px | [OK/Fix] |329| Micro | [specific element] | [X]px | [Y]px | [OK/Fix] |330| Meso | [specific element gap] | [X]px | [Y]px | [OK/Fix] |331| Meso | [specific element gap] | [X]px | [Y]px | [OK/Fix] |332| Macro | [section gap] | [X]px | [Y]px | [OK/Fix] |333| Macro | [section gap] | [X]px | [Y]px | [OK/Fix] |334335- **Ratio status:** Macro:[meso ratio] / Meso:Micro ratio [X:1 -- target 2:1 minimum]336- **Proximity violations:** [elements grouped incorrectly by spacing]337- **White space fix:** [specific values to change]338339---340341### Focal Point Analysis342- **Recommended scan pattern:** [Z-pattern / F-pattern / Gutenberg / circular] -- rationale343- **Current focal point:** [element, position as % from top-left, e.g. "50% × 20%"]344- **Recommended focal point position:** [element should be at X% × Y%, technique used]345- **Eye-flow path:** [describe the intended L1 -> L2 -> CTA path]346- **Focal point failure:** [none / no focal point / competing / off-pattern / leads nowhere]347- **Focal point fix:**348 - Move [element] to [position] (rule of thirds intersection at X:Y or golden ratio at Xpx)349 - [Additional adjustments to support the eye-flow path]350351---352353### Balance Analysis354- **Balance type:** [symmetric / asymmetric / radial]355- **Left-right weight ratio:** [approximate, e.g. 1.3:1 -- acceptable / 2.4:1 -- needs adjustment]356- **Above/below fold weight distribution:** [heavy top / heavy bottom / balanced]357- **Balance fix:** [specific element weight adjustments]358359---360361### Prioritized Recommendations362363| # | Element | Change | Principle | Exact Measurement | Impact |364|---|-----------------------------|-----------------------------------------|----------------|--------------------------------|--------|365| 1 | [element name] | [specific change] | [principle] | [px / ratio / %, exact value] | High |366| 2 | [element name] | [specific change] | [principle] | [px / ratio / %, exact value] | High |367| 3 | [element name] | [specific change] | [principle] | [px / ratio / %, exact value] | Medium |368| 4 | [element name] | [specific change] | [principle] | [px / ratio / %, exact value] | Medium |369| 5 | [element name] | [specific change] | [principle] | [px / ratio / %, exact value] | Low |370371---372373### Implementation Order3741. [First change -- fixes the most critical issue, enables other changes]3752. [Second change -- builds on first]3763. [Third change -- refines]377```378379---380381## Rules3823831. **Every spacing value must be on the 8px base unit grid.** Values of 8, 16, 24, 32, 40, 48, 56, 64, 80, 96px are valid. Values like 13px, 22px, or 37px indicate freeform spacing and must be corrected to the nearest 8px increment unless a 4px sub-grid is explicitly justified for micro-spacing.3843852. **There must be exactly one L1 element per page or per distinct viewport screen.** If the layout is scrollable, each viewport-height section may have one L1, but the overall page-level L1 (the above-the-fold dominant element) takes precedence. Multiple competing L1s are always a hierarchy failure, not a "balanced design choice."3863873. **Macro spacing must be at minimum 2× meso spacing, and meso must be at minimum 2× micro spacing.** If a layout has 24px section gaps (macro) and 16px component gaps (meso), that is a violation -- both numbers are too close. Flag it and provide corrected values.3883894. **Never make a recommendation without a specific, measurable value.** "Add more breathing room" is not valid. "Increase the gap between the testimonials section and the pricing section from 32px to 80px" is valid. Every recommendation must be precise enough for a developer to implement without judgment.3903915. **Always identify the intended scan pattern before evaluating focal point placement.** A focal point is only "wrong" relative to the expected scan pattern for that content type. A Z-pattern landing page with a focal point at lower-left is misplaced. An F-pattern article with a focal point at lower-left may be correct for a pull-quote anchor.3923936. **Grid recommendations must include three values: column count, gutter size, and margin size.** Recommending "a 12-column grid" is incomplete. The full recommendation is "12-column grid, 24px gutters, 80px margins, 1200px max-width container." All four parameters must be specified.3943957. **Do not pathologize intentional asymmetry.** If a layout is intentionally grid-breaking (creative portfolio, editorial feature, artistic campaign), evaluate whether the breaks are consistent and purposeful. An intentional rule break that is applied consistently is a design choice. A sporadic misalignment is an error. Ask the user to clarify intent when unsure.3963978. **Contrast ratios for text must meet minimum thresholds.** For hierarchy evaluation, note that text elements failing WCAG 2.1 AA contrast (4.5:1 for normal text, 3:1 for large text ≥ 18pt / 14pt bold) cannot function as hierarchy anchors regardless of their size, because they are illegible at distance. Flag contrast failures separately from hierarchy issues.3983999. **Acknowledge what is working before listing failures.** A layout analysis that lists only problems is incomplete. Identify at least two elements or areas where the current layout succeeds. This gives the designer reference points to maintain while making changes.40040110. **Print and digital layouts use different unit systems and must not be mixed.** Digital recommendations in pixels or rem. Print recommendations in millimeters or points. If a hybrid situation exists (designing a digital-first asset that will also print), specify both unit systems explicitly and note where they diverge.40240311. **Recommendations must be ordered by visual impact, not ease of implementation.** The change that most improves the layout comes first even if it is harder to implement. The user can choose to skip difficult changes -- that is their decision -- but the priority order must reflect actual impact.40440512. **Do not assume a grid exists unless evidence of one is provided.** If the user describes a layout without specifying a grid system, state "no grid apparent" and recommend one rather than analyzing against a grid that may not exist.406407---408409## Edge Cases410411### No Existing Layout -- User Wants Principles Applied from Scratch412If the user has content but no layout, this skill becomes a **layout blueprint** mode rather than an audit mode. Define the appropriate grid for their content type and dimensions, assign hierarchy tiers to each content element they list (matching intended reading order to visual weight recommendations), specify all three tiers of white space, and identify which scan pattern to design for. Output a Layout Blueprint rather than a Layout Analysis. Note that for a full wireframe with interaction annotations, the user should proceed to `wireframe-specification` after receiving the blueprint.413414### Data-Dense Dashboard or Admin Panel415Standard white space ratios compress significantly. Micro: 4-8px (use 4px base unit instead of 8px for these layouts). Meso: 8-16px. Macro: 24-40px. The 2:1 ratio rule still applies -- maintain relative proportion even though absolute values are smaller. Hierarchy shifts from size-dominant to color-and-weight-dominant because vertical space is limited and multiple panels have equivalent importance. Multiple L1 focal points are acceptable when each is contained within a visually enclosed panel (a card with a border or background fill that creates enclosure). F-pattern applies: top row of metrics receives the most attention. Place the most critical KPIs in the first row, leftmost position.416417### Single-Element or Hero-Only Layouts (Splash Screens, Covers, Billboards)418The single element IS the focal point by definition -- the analysis shifts entirely to evaluating placement, white space ratio, and relationship to the frame. Target content-to-white-space ratio: 25-40% content, 60-75% white space for maximum impact (tight content-to-frame ratios feel suffocating on splash screens). Evaluate the element's position against rule of thirds (preferred) or optical center. Check whether the element is sized proportionally to the frame -- the element should not exceed 60% of the shorter canvas dimension. For billboard/OOH signage viewed at 30+ meters: minimum stroke weight 4pt equivalent, high contrast required (minimum 5:1 at full resolution), and the focal element should occupy 40-60% of the frame to remain readable at distance.419420### Print Layout with Bleed and Safe Zones421Three boundaries must be defined: bleed edge (design extends 3mm past trim), trim line (physical cut line), safe zone (5mm inside trim -- no critical content outside this boundary). Text that crosses the trim line must be justified by design intent, not accident. Evaluate hierarchy in terms of above-fold defined as the top half of the printed page (the upper half receives significantly more attention when print is displayed on a shelf or folded). Baseline grid is critical in print: use a consistent leading value (e.g., 12pt leading) and snap all text blocks to multiples of this leading value for cross-column alignment.422423### Intentionally Rule-Breaking Creative Layouts (Editorial, Portfolio, Campaign)424Do not apply standard grid audit rules mechanically. Instead, evaluate whether the rule-breaking is: (a) consistent -- the same rule is broken in the same way throughout, creating a system; (b) purposeful -- the break creates tension, movement, or emphasis that serves the design intent; (c) controlled -- the breaks are surrounded by structure that provides a reference point for the eye. An intentional break only reads as intentional if at least 60% of the layout is conventionally structured. If everything is breaking rules, nothing feels like a rule break -- it just looks chaotic. Recommend introducing at least one consistent structural anchor (a persistent margin, a baseline grid, a repeated element size) to make the rule-breaking legible as intentional.425426### Mixed-Medium Layouts (Web Page That Also Prints)427CSS print stylesheets address some issues, but layout principles must be evaluated for both contexts separately. In digital mode: fluid behavior, scrolling, interaction states. In print mode: fixed canvas, no scroll, bleed/safe zone rules apply. Document both assessments. Key differences: digital macro spacing (64-96px) will appear as vast empty space in print (20-30mm equivalent); reduce proportionally. Typography that is 16px on screen may be 12pt in print -- verify both are readable in their respective contexts. Color mode shift (RGB to CMYK) can change contrast ratios; flag any text/background combinations where CMYK shift might drop below 4.5:1.428429### Responsive Layout -- Multiple Breakpoints in Scope430This skill applies to single-viewport static layout analysis only. If the user needs to evaluate layout across breakpoints, the evaluation should be run separately for each major breakpoint (desktop 1440px, tablet 768px, mobile 375px). Common issues at breakpoints: hierarchy inversions (what is L1 at desktop becomes L3 when columns stack on mobile); white space ratio collapses (macro spacing set in px becomes disproportionately large on small screens -- prefer rem or viewport-relative units); grid collapses that create unintended focal point shifts. For full responsive layout design guidance, refer the user to `responsive-layout-design`.431432### User Provides Only a Problem Description with No Visual Reference433When no visual is provided, the analysis must be structured as a **diagnostic interview + conditional recommendation.** Ask targeted questions: what is the canvas size? How many major sections? What is the approximate column count being used? What is the approximate size of the headline versus body text? Is there a clear hero/focal element? Use the answers to construct the most likely layout state and produce a conditional analysis ("If your section gaps are approximately 24-32px, the macro/meso ratio is likely violated -- here is the fix"). Explicitly label all assumptions and invite correction. Do not produce a high-confidence analysis from a vague description.434435---436437## Example438439**Input:** "I have a SaaS product landing page. The layout from top to bottom is: navigation bar, hero section with a headline and subtext and a button, a 'social proof' bar with five logo images, a three-column features section with icon/title/text in each column, a testimonials section with three testimonial cards, a pricing section with three pricing tiers, and a footer. The page is 1440px wide. It looks too flat and nothing stands out. Every section feels the same importance and the CTA button in the hero barely registers."440441**Output:**442443## Layout Analysis: SaaS Product Landing Page444445### Context446- **Content type:** Marketing / SaaS landing page447- **Dimensions:** 1440px wide, full-length scrollable448- **Grid system in use:** Unknown -- 12-column assumed based on three-equal-column feature section449- **Primary user goal:** Visitor should immediately understand the product value, then click the hero CTA to start a trial or learn more450451---452453### Overall Assessment454| Principle | Rating | Status | Key Finding |455|-------------------|--------|-------------|-----------------------------------------------------------------|456| Grid alignment | ★★★☆☆ | Adequate | Assumed 12-col grid may be in use, but no confirmation; verify |457| Visual hierarchy | ★★☆☆☆ | Poor | No L1 established -- every section has equivalent visual weight |458| White space | ★★☆☆☆ | Poor | Likely macro = meso violation causing sections to blur together |459| Focal point | ★★☆☆☆ | Poor | Hero CTA is visually weak; no dominant focal entry point |460| Visual balance | ★★★☆☆ | Adequate | Three-column structures are likely balanced; hero unclear |461462---463464### What Works Well465- The three-column feature section (icon / title / text) and three-card testimonials section are a structurally sound modular grid approach -- this creates good horizontal rhythm and reduces the amount of work needed in those sections.466- A clear sequential narrative exists in the content order (hero -> proof -> features -> social validation -> pricing -> conversion) -- the content strategy is sound. The layout problem is execution, not structure.467468---469470### Grid Analysis471- **Current grid:** Likely 12-column based on three equal-column sections. Gutter and margin widths unknown. Assumed: 24px gutters, 120px margins.472- **Base unit:** Unknown -- recommend establishing 8px as base unit throughout473- **Recommended grid:** 12-column at 1200px max-width container (centered in 1440px canvas), 24px gutters, 120px left/right margins (8.3% of 1440px). This centers the content comfortably and leaves sufficient breathing room on the 1440px canvas.474- **Misaligned elements (probable):**475 - Social proof logos: If centered within the full 1440px canvas without snapping to the 12-column grid, logos will float inconsistently. Align the logo row to a 6-column centered span (columns 4-9 of 12).476 - CTA button in hero: Likely left-aligned with the headline but not constrained to a maximum width. Set the button width to auto with horizontal padding of 32px each side, ensuring it does not exceed 240px width.477- **Grid fix:** Establish the 1200px max-width container explicitly. All section content (text blocks, cards, feature columns) should be constrained to this 1200px grid. Section backgrounds (full-bleed color bands or images) may span the full 1440px canvas width.478479---480481### Hierarchy Analysis482- **Intended L1:** Hero section headline -- this is the primary value proposition and the first message the visitor should receive483- **Current L1:** Likely nothing -- the hero headline, section headings, and testimonial headings are probably at similar visual weights, creating the "everything feels the same" symptom described484- **Hierarchy tiers as they likely exist:**485 - L1: No clear element (hero image or headline shares weight with section headings)486 - L2: Section headings, feature titles, testimonial cards -- all at similar size487 - L3: Body text, testimonial text, pricing descriptions488 - L4: Nav links, footer links, social proof labels489- **Failure mode:** No L1 established -- multiple elements competing for the same visual tier490491- **Hierarchy fix:**492 - Set hero headline493494…(truncated)