---

name: figma-spacing-system
description: "Design a spacing and layout token system for a Figma design system. Use when asked to create a spacing system, define layout tokens, set up a grid system, build a spacing scale, or establish layout foundations for a Figma file. Produces a complete spacing scale, grid definition, component spacing conventions, and Figma implementation guide."

Figma Spacing System Skill

Produces a complete spacing and layout token system — the foundation that makes a design system consistent and developer handoff unambiguous.

Required Inputs

• Platform (iOS / Android / Web / Multi-platform)
• Base unit (4px / 8px — default to 8px)
• Design system name (for token naming)
• Component density (compact / standard / comfortable)
• Grid requirements (or "derive from platform standard")

Output Structure

1. Base Unit

[4px or 8px] with rationale. All values must be multiples.

2. Spacing Scale

Token	Value	Use case
spacing.none	0px	Removing space intentionally
spacing.xs	4/8px	Icon padding, tight labels
spacing.sm	8/12px	Internal component padding compact
spacing.md	12/16px	Internal component padding standard
spacing.lg	16/24px	Section padding, card internal
spacing.xl	24/32px	Between components
spacing.2xl	32/48px	Section separation
spacing.3xl	48/64px	Page-level breaks
spacing.4xl	64/96px	Hero sections

3. Layout Grid

Mobile (375px): 4 columns, margin [value], gutter [value]
Tablet (768px): 8 columns, margin [value], gutter [value]
Desktop (1440px): 12 columns, margin [value], gutter [value], max content width [value]

4. Component Spacing Conventions

Context	Token	Example
Button horizontal padding	spacing.md	Left/right
Button vertical padding	spacing.sm	Top/bottom
Card internal padding	spacing.lg	All sides
Input padding	spacing.sm vertical, spacing.md horizontal
Icon gap from label	spacing.xs
Section gap	spacing.xl

5. Figma Implementation

1. Create SPACING page documenting each token visually
2. Resources > Variables > create Number collection named Spacing
3. Apply variables to Auto Layout padding/gap values
4. Share token names with engineers as-is or via Tokens Studio

6. Anti-Patterns to Avoid

• Values not on the scale (13px, 22px) — round to nearest token
• Absolute pixel values in components instead of tokens
• Mixing 4px and 8px base units in the same product

Quality Checks

• All token values are multiples of the base unit
• Scale covers xs through 4xl
• Grid defined for all relevant breakpoints
• Component conventions cover common decisions
• Figma implementation steps included

Anti-Patterns

• Do not create a spacing scale with arbitrary values — the scale must follow a consistent mathematical ratio (e.g. 4px base, 8-4-2 system)
• Do not define spacing tokens without Figma implementation instructions — token names alone are not actionable
• Do not create a spacing system that doesn't account for component-level spacing conventions — global tokens and component usage must both be documented
• Do not skip grid definitions — spacing without a grid system is incomplete layout foundation documentation
• Do not produce a spacing system that ignores responsive behaviour — define how spacing adapts across breakpoints

Example Trigger Phrases

• "Create a spacing system for our Figma design system"
• "Define our spacing tokens for Figma"
• "Set up a grid and spacing scale for [product]"
• "What spacing values should we use in our design system?"
• "Help me build the layout foundation for our Figma file"