better-layout

Reviews and structures web interface layouts using spacing, alignment, and responsive principles.

Updated Sep 3, 2026
One-click install
npx skills add https://github.com/xzedm/clipplic-landing --skill better-layout-xzedm
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: better-layout
Source: https://github.com/xzedm/clipplic-landing/tree/main/.agents/skills/better-layout
Command: npx skills add https://github.com/xzedm/clipplic-landing --skill better-layout-xzedm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Web interfaces often suffer from unclear visual hierarchy, inconsistent spacing, misaligned elements, and layouts that break under resizing, localization, or RTL direction. This Skill provides concrete layout principles and a structured review format to catch and fix these issues in frontend code. ## Core Features & Use Cases - Layout Principles: Ten actionable rules covering grouping with negative space, shared alignment edges, logical CSS properties, reading order, progressive disclosure, safe areas, and content-driven breakpoints. - Structured Code Review: A standalone review output format with severity-rated findings (HIGH/MEDIUM/LOW), before/after fixes, verification steps, and a final verdict. - Use Case: When building a settings page in React with Tailwind, apply the skill to replace separator lines with spacing-based grouping, switch physical margins to logical properties for RTL support, and verify the layout holds at small viewports. ## Quick Start Review the layout of my React components in src/ and report spacing, alignment, and responsive issues with fixes.

Frequently Asked Questions about better-layout

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

FAQPage Schema
How do I review frontend code for layout problems?▼

Apply the ten layout principles covering grouping, alignment, spacing, and adaptivity, then report findings in a table with severity, file location, before/after code, and the violated principle. Finish with verification checks across viewports and a Block, Needs changes, or Approve verdict.

How should I group UI elements without separator lines?▼

Use negative space as the primary grouping tool: the gap between groups must be at least twice the gap within a group, such as 8px intra-group and 16px or more inter-group. Reserve separator lines for cases where spacing alone cannot carry the structure.

Does this layout guidance work with Tailwind and CSS-in-JS?▼

Yes, all layout changes are expressed in the project's existing styling system, whether Tailwind, plain CSS, or CSS-in-JS. The skill explicitly forbids introducing a second styling approach into a project.

How do I make layouts work with RTL languages?▼

Use CSS logical properties like margin-inline-start and padding-inline-end instead of physical left/right properties for direction-dependent layout. Reserve physical properties only for genuinely physical geometry, and test the layout mirrored for RTL.

When should responsive breakpoints be defined?▼

Breakpoints should come from the content, not device presets like 768 or 1024 pixels. Keep the expanded layout as long as it genuinely fits, collapse late, and prefer container queries for component-level adaptation.

What are the limitations of fixed-width text containers?▼

Fixed widths and heights on text containers break under localization because string growth varies substantially by language. Use max-width with wrapping rows instead, and test with pseudo-localization and representative locales.