What is the spacing system skill?
The spacing system skill is a short SKILL.md in the Owl-Listener designer skills repo, inside the ui-design plugin. It tells an AI coding agent to pick a base unit, build a named scale from 2xs to 3xl, and apply inset, stack and inline spacing by clear rules.
It is a compact skill from the ui-design plugin of the designer skills collection. Its description is to create a spacing scale from a base unit with rules for when each step applies, for standardising padding and margins.
The file is short on purpose. It sets a base unit, lists a named scale, defines four spacing types and gives application rules, so the agent stops choosing padding values one component at a time.
What changes in your agent's output
- Spacing values come from a named scale of 2, 4, 8, 16, 24, 32, 48 and 64 pixels, not arbitrary numbers.
- Related items get smaller steps, while distinct sections get larger ones.
- Padding, vertical stacks, inline gaps and grid gaps are treated as separate spacing types.
- Dense data views can drop one step and reading views can add one, through density modes.
Who it is for
Best for
- Developers whose agent-built pages have uneven padding and margins across components.
- Teams standardising spacing before writing tokens, then naming them with design-token.
- Designers who want column and gutter rules too, which belong to the sibling layout-grid skill.
Not for
- Anyone who needs page level columns and gutters. The skill description points to layout-grid for that.
- Teams who want a long worked guide. The file is a short rule list and gives no code samples.
- People wanting automated checks, since nothing in it measures rendered spacing.
Use it with UiChemy
Fix the spacing scale in your design first, then use UiChemy Figma to WordPress to convert the finished design into an editable WordPress page. Click Get Started on uichemy.com.
How to install Spacing System Skill: A Spacing Scale From One Base Unit
/plugin marketplace add Owl-Listener/designer-skillsThe skill ships inside the ui-design plugin, so installing it brings the other skills in that plugin too.Add the marketplace
Run the command above in Claude Code. The README says this only registers where the skills live and nothing installs yet.
Install the ui-design plugin
Run /plugin install ui-design@designer-skills, or type /plugin, open the Discover tab and tick ui-design.
Gemini CLI route
The README says each plugin is also a Gemini CLI extension. Clone the repo and copy its .gemini/extensions folder into your project.
Ask for spacing
Ask the agent to standardise padding and margins on a page or to create a spacing scale from an 8px base.
Check that it loaded
Ask the agent to define a spacing scale for a card grid. It should return a named scale from a base unit and say which step applies to inset, stack and inline spacing.
Key features
- Base unit choiceThe agent chooses a base unit, typically 4px or 8px, and builds every other value from it.
- Named scaleProvides steps from 2xs at 2px through xs, sm, md, lg, xl and 2xl to 3xl at 64px.
- Inset spacingCovers padding inside containers, in equal form or as squish and stretch variants.
- Stack spacingDefines the vertical space between elements that sit one above another.
- Inline spacingDefines the horizontal space between inline elements such as icons and labels.
- Grid gapCovers the space between grid or flex items as its own spacing type.
- Proximity based rulesRelated items use smaller steps and distinct sections use larger steps, with page margins kept consistent per breakpoint.
- Density modesCompact reduces spacing by one step, comfortable is the default, and spacious adds one step for reading focused views.
- Use the scale onlyBest practices say to avoid arbitrary values, keep spacing consistent inside components and document spacing intent, not just values.
- Viewport testingThe skill asks for spacing to be tested at different viewport sizes.
Frequently asked questions
What is the spacing system skill?
It is a SKILL.md from the Owl-Listener designer skills repo, in the ui-design plugin. It tells an AI coding agent to create a spacing scale from a base unit and apply it with rules for padding, stacks, inline gaps and grid gaps.
How do I install the spacing system skill?
Run /plugin marketplace add Owl-Listener/designer-skills in Claude Code, then install the ui-design plugin with /plugin install ui-design@designer-skills. The README also describes a Gemini CLI extension route that copies the repo's .gemini extensions folder.
Which base unit does it use?
The skill says to choose a base unit, typically 4px or 8px. Its sample scale runs 2, 4, 8, 16, 24, 32, 48 and 64 pixels, named 2xs through 3xl, and you can adjust it to your base.
What are the spacing types it defines?
Four types: inset for padding inside containers, stack for vertical space, inline for horizontal space between inline elements, and grid gap for space between grid or flex items. Each gets scale steps by how related the items are.
Does it handle columns and gutters?
No. The skill description says to use layout-grid for page level columns and gutters, so see layout-grid for that job. This skill covers padding and margin steps only, which keeps each file small.
Does it cover compact and spacious layouts?
Yes. It defines density modes: compact reduces spacing by one step for data heavy views, comfortable is the default, and spacious increases spacing by one step for reading focused views.
Can I use it with Cursor or Codex?
The README names Claude Code and Gemini CLI as the supported tools. For other agents, you could copy the SKILL.md text into that tool's rules, but the repo does not document that route.
How does it relate to design tokens?
It sets the scale of values and rules for using them. Naming and tiering those values as tokens is a separate step, handled by skills such as design-token and typography-scale for type.


