Tooluck logoTooluck
SKILL.md

better-layout

Agent skill fromjakubkrehel/skills

Sets grouping, alignment, reading order, responsive structure and room for translated text, so a layout holds up when it is resized, translated or mirrored.

How to install better-layout

install better-layout
# install the skills pack with the skills CLI
npx skills add jakubkrehel/skills

# or add only this skill to Claude Code: copy the folder

skills/better-layout/

# into

~/.claude/skills/better-layout/ (all projects)

.claude/skills/better-layout/ (one project)

skills/better-layout/SKILL.md

MITFull file
1# Layout
2
3This skill sets grouping, alignment, spacing and responsive structure. It then stress-tests that structure by resizing it, translating it and mirroring it for RTL.
4
5Write every fix in the project's styling system. The numbers below apply only where the project has no spacing scale or density system; otherwise use its tokens. A finding needs a failure you can show, such as a clip, an overlap, a broken mirror or a misread group. A value that differs from these starting points is not one.
6
7Hit areas and focus behavior belong to `better-accessibility`. Radius, shadows and animation belong to `better-ui`. Line length, text spacing and truncation mechanics belong to `better-typography`. The words themselves belong to `better-writing`.
8
9## Group with space, not lines
10
11Space groups first, background shapes second, separator lines last and only where space alone can't carry the structure. The gap between groups is at least 2× the gap within one, so `8px` inside a group means `16px` or more between groups. Recipes are in [grouping-and-alignment.md](grouping-and-alignment.md#group-with-space-not-lines).
12
13## Keep controls distinct from content
14
15Give every interactive element a background shape, a border, an underline or a consistent placement zone such as a toolbar. A control styled like the static text beside it does not read as a control. See [grouping-and-alignment.md](grouping-and-alignment.md#keep-controls-distinct-from-content).
16
17## Align to shared edges
18…

Excerpt shown under the repository's MIT license.

More skills in skills

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates