gestalt-similarity

Group related UI elements using shared visual attributes like color, size, and shape.

6|3|Updated May 3, 2026
One-click install
npx skills add https://github.com/HDeibler/universal-design-principles --skill gestalt-similarity
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gestalt-similarity
Source: https://github.com/HDeibler/universal-design-principles/tree/main/plugins/perception-and-hierarchy-principles/skills/gestalt-similarity
Command: npx skills add https://github.com/HDeibler/universal-design-principles --skill gestalt-similarity

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you prevent users from misreading your interface by making perceptual grouping match how items relate in meaning, not just where they appear.

Core Features & Use Cases

  • Similarity-based grouping: Style elements with shared attributes (color, shape, size, orientation) so users perceive them as belonging together, even when spacing is inconsistent.
  • Similarity vs. contrast: Use deliberate differences to distinguish roles (e.g., primary vs. secondary actions, status states) while keeping like-for-like consistent.
  • Fixes common UI failures: Reduces missed related items, fragmented lists, and ambiguous statuses caused by inconsistent visual treatment.

Quick Start

Apply the same color, shape, and sizing conventions across items that represent the same category or role, and ensure functionally different roles use clear contrasting styling.

Frequently Asked Questions about gestalt-similarity

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I group related UI elements when spacing alone isn't enough?

Use Gestalt similarity to group related UI elements by applying consistent design tokens for color, size, and shape across items with shared meaning. This ensures perceptual grouping matches functional relationships even when layout proximity is inconsistent.

What is Gestalt similarity in interaction design?

Gestalt similarity in interaction design is a perceptual principle where elements sharing visual attributes like color, size, or shape are perceived as belonging together. It ensures perceptual grouping matches semantic relationships to prevent misreading interfaces.

How do I use visual hierarchy to distinguish primary and secondary actions?

Distinguish primary and secondary actions by applying deliberate visual contrast between different roles while keeping like-for-like items consistent. Use contrasting design tokens for different roles while maintaining shared styling for similar functions.

When should I use similarity-based grouping instead of proximity for dashboard cards?

Use similarity-based grouping for dashboard cards and status indicators when proximity alone cannot reliably communicate relationships. Apply shared color, size, and shape conventions to prevent missed related items and ambiguous statuses.

Do I need consistent design tokens to apply similarity grouping to navigation?

Yes, consistent design tokens are required for similarity cues to group navigation and list items effectively. Color serves as the strongest cue, followed by size and shape, with contrast applied for different roles and accessibility-safe status differentiation.

Why do users misread my interface status indicators and list groupings?

Users misread status indicators and list groupings when inconsistent visual treatment causes fragmented lists and ambiguous statuses. Applying Gestalt similarity ensures shared visual attributes indicate shared meaning, preventing users from missing related items.