К основному содержанию
скилл CX Codex

layout-grid · daveebbelaar — скилл для Claude Code: проверка вёрстки и сетки SwiftUI

Скилл layout-grid для Claude Code проверяет сетку и выравнивание в приложениях macOS SwiftUI. Запускается при создании кастомных экранов, карточек, форм и после изменения вёрстки.

MIT 1 000 установок ★ 1 933 обновлён 2026-11-05

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add daveebbelaar/bama --skill layout-grid -a claude-code
Открыть на GitHub

Что делает layout-grid

Скилл заменяет случайные отступы единой масштабной сеткой и тремя проверками на смещения и неровности. Скрипт tools/grid-lint.sh ищет сырые числа в коде, tools/check-layout.swift измеряет реальные фреймы в режиме снимков экрана, а третья проверка рисует сетку поверх окна при запуске приложения с переменными окружения вроде APP_GRID=1.

Правила задают шаги отступов от четырех пунктов до тридцати двух, единые левые края колонок и правила вложенности контейнеров. Контейнеры размечаются через модификаторы .gridArea и .gridProbe. Для работы требуются окружение macOS и проект SwiftUI со структурой файлов шаблона.

Какие задачи решает

  • найти сырые отступы и размеры не по сетке
  • измерить реальные фреймы в режиме снимков экрана
  • проверить выравнивание краев колонок в окне
  • нарисовать визуальную сетку поверх интерфейса приложения

Примеры запросов агенту

  • Проверь сетку в коде последней страницы через tools/grid-lint.sh.
  • Запусти проверку макета по файлам снимков через swift tools/check-layout.swift.
  • Запусти приложение со специфичными переменными для отрисовки сетки.

Как установить layout-grid

1Через Skills CLI (Vercel)

npx skills add daveebbelaar/bama --skill layout-grid -a claude-code

2Вручную: положить файлы

~/.claude/skills/layout-grid/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/layout-grid/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о layout-grid

Как установить layout-grid в Claude Code?

Выполните команды npx skills add daveebbelaar/bama --skill layout-grid -a claude-code и обратитесь к файлу ~/.claude/skills/layout-grid/SKILL.md.

Что делает layout-grid?

Скилл автоматизирует проверку отступов, выравнивания и сетки в проектах macOS SwiftUI с помощью линтера, анализаторов макета и наложения визуальной сетки.

Что нужно для работы layout-grid?

Требуются операционная система macOS, проект на SwiftUI и настроенный шаблон с утилитами в папке tools.

Исходный текст

SKILL.md · MIT
---
name: layout-grid
description: Grid and alignment rules for a macOS SwiftUI app, with three checks that catch misalignment (a lint for off-grid numbers, a layout probe that measures real frames in snapshot mode, and a grid overlay). Use when building or reviewing a custom page, card, row, form, or sheet, after every build that touched layout, or when the user says something looks misaligned, crooked, cramped, or unevenly spaced.
---

# Layout grid

Agents guess numbers. A guessed `.padding(13)` looks almost right and
makes the whole app feel slightly off. This skill replaces guessing with
one scale and three checks that fail when something is off.

The template has everything in place: `Sources/<App>/UI/Grid.swift` and
`tools/`. For an app made before this skill, copy `UI/Grid.swift`,
`tools/grid-lint.sh`, and `tools/check-layout.swift` from the `new-mac-app`
skill's template, and the layout file line from its `Snapshot.swift`.

## The rules

1. Every padding, spacing, and size comes from `Space`: `xs 4`, `sm 8`,
   `md 12`, `lg 16`, `xl 20`, `xxl 24`, `section 32`. Raw numbers are
   0, 1, 2, or a multiple of 4.
2. Pages and windows have a 20 pt margin (`Space.margin`). Cards pad 16
   (`Space.lg`). Related controls sit 8 apart, groups 20 to 24, sections 32.
3. Each column has one leading edge. Titles, text, cards, and buttons in a
   column start on the same x. Indent on purpose, by a step of the scale.
4. Let containers do the aligning:
   - Labels with controls: `Form` with `.formStyle(.grouped)`, or
     `.columns` for the Mac layout of right-aligned labels.
   - Rows and columns of values: `Grid` and `GridRow`.
   - A label with a value: `LabeledContent`.
   - Text of different sizes in one row: `HStack(alignment: .firstTextBaseline)`.
   - Numbers in a column: `.monospacedDigit()`, trailing aligned.
   - An icon with text: `Label`.
5. Sheets are 360, 480, or 640 wide. Controls take their height from
   `.controlSize`, never from a fixed height.
6. Nested corners are concentric: inner radius = outer radius - padding.
7. `.offset` and `.position` move a view after layout, so nothing lines up
   with it. Use them only for motion and drag previews, with
   `// grid: ok <why>` on the line.
8. Long text truncates with its full value in a tooltip. Nothing clips.

## Check 1: lint the code

Run it after every build that touched views:

```bash
tools/grid-lint.sh
# Sources/Tasks/TaskRow.swift:14: off grid (10): .padding(.horizontal, 10)
# FAIL grid-lint: 1 lines off the grid
```

Fix each line with a `Space` token.

## Check 2: probe the real layout

Mark what you lay out yourself: the page, its sections, cards, rows in a
card, sheet content. System lists, forms, sidebars, and toolbars align
themselves and need no probes. Your own rows beside them do.

A check only sees what has probes. A screen with two probes passes while
everything else is off, so read the count in the PASS line.

```swift
VStack(alignment: .leading, spacing: Space.xxl) {
    Text("Today").gridProbe("title", area: "page")
    StatsRow().gridProbe("stats", area: "page")
    TaskCard()
        .gridArea("card", inset: Space.lg)
        .gridProbe("card", area: "page")
}
.padding(Space.margin)
.gridArea("page")
```

`.gridArea` marks a container and its inset. `.gridProbe` marks a view in
it. Probes with the same `edge` (default `"lead"`) must share one leading
edge. Pass `edge: nil` for views that sit side by side.

Snapshot mode writes a `<page>-<mode>-layout.json` next to every PNG.
Check them:

```bash
swift tools/check-layout.swift /tmp/<App>-shots/*-layout.json
# PASS today-light-layout.json: 12 probes in 2 areas
# FAIL inbox-light-layout.json
#   - edge page/lead has 2 leading edges: title 320, list 324
```

It checks that every probe:

1. Starts on a whole or half point, so its edges stay sharp.
2. Starts a multiple of 4 pt from its area's edge.
3. Stays inside its area's inset on both sides.
4. Shares one leading edge with the others on its edge.
5. Sits a multiple of 4 pt below the probe above it.
6. Never overlaps another probe in its area.

### Line up across areas

Rules 2 to 6 stay inside one area. Views in different areas, like text in a scroll
view and a chat box outside it, need an edge that starts with `=`:

```swift
TextColumn().gridProbe("column", area: "", edge: "=reading")
Composer().gridProbe("composer", area: "", edge: "=reading")
```

| Edge | Must match |
| --- | --- |
| `=name` | left and right |
| `=name<` | left |
| `=name>` | right |
| `=name\|` | center |
| `=name_` | bottom |

These probes skip rules 2 to 6, so a view off the 4 pt grid can still match a
system edge. To check one view against two groups, add a second `.gridProbe` with
a different name, because a probe with the same name replaces the first.

Run the snapshots once with scroll bars on, because a scroll bar that takes width
moves centered content (`mac-design`, app-shell.md):

```bash
tools/snap.sh -AppleShowScrollBars Always
```

The probes keep one frame per name across all windows. When a second window shows
the same views, its layout file mixes both windows, so check that window by its PNG.

## Check 3: look at the grid

When a check fails and the cause is not clear, draw the grid over the
window:

```bash
APP_GRID=1 APP_STORE=/tmp/<App>-test.store APP_SNAPSHOT=/tmp/<App>-grid \
  ~/Applications/<App>.app/Contents/MacOS/<App>
```

The PNGs show an 8 pt grid, each area in blue with its inset dashed, and
each probe in pink with its name. Open them with the Read tool.

## Fix a failure

| Message | Usual cause | Fix |
| --- | --- | --- |
| starts 23 pt into page | a raw padding on one child | remove it, use the stack's `Space` padding |
| 2 leading edges | a centered stack, or one child with extra padding | `alignment: .leading` on the stack |
| gap 10 pt | `spacing: 10`, or a `Spacer(minLength:)` | a `Space` token |
| inside its 20 pt inset | a missing margin, or a fixed width wider than the parent | `.padding(Space.margin)`, `maxWidth` instead of `width` |
| overlap | `.offset`, `.position`, or a fixed height | remove it, let the stack size the view |
| x between pixels | a fractional number | a whole number from `Space` |
| `=name` has different left edges | a scroll bar that takes width, or a panel's gap on the content's side | `mac-design`, app-shell.md, "Line up the content" |

Done when `tools/grid-lint.sh` passes, `tools/check-layout.swift` passes
on the layout files of every page you touched, and every custom page and
card has a `.gridArea` with probes on its main parts.

© daveebbelaar · MIT · daveebbelaar/bama

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →

Сначала — layout-grid от других авторов.

layout-grid Owl-Listener Скилл layout-grid на Claude Code задаёт адаптивную сетку страницы: колонки, отступы между ними, поля и поведение на брейкпоинтах. Разбирает анатомию сетки и привязывает контент к разметке вместо произвольного расположения блоков. CX Codex +1 2 900установок image-first-grid-layout MengTo Скилл image-first-grid-layout для Claude Code задаёт правила вёрстки экранов с полноэкранными фото, полупрозрачными блоками и линиями сетки. Используется для кинематографичных промо-страниц. CX Codex +1 1 800установок framed-grid-layout MengTo Скилл framed-grid-layout задаёт правила вёрстки страниц с тонкими видимыми границами секций, L-образными уголками и строгой привязкой к сетке. CX Codex +1 1 800установок framer-motion-layout C-Jeril Скилл framer-motion-layout обучает ассистента строить анимации макета во Framer Motion с помощью layout, связывать элементы через layoutId и плавно убирать блоки через AnimatePresence. CX Codex +1 876установок iphone-duo-adaptive-layout mirzaaghazadeh Скилл iphone-duo-adaptive-layout для Claude Code учит агента строить интерфейсы с учётом сгиба iPhone Duo: резервные области, вытеснение контента, контейнеры split и overlay. Прячет кнопки и текст от изгиба дисплея. CX Codex +1 1 000установок hig-components-layout raintree-technology Скилл hig-components-layout помогает спроектировать навигацию и вёрстку для приложений под платформы Apple по правилам Human Interface Guidelines. CX Codex +1 830установок makepad-2.0-layout ZhangHanDong Скилл makepad-2.0-layout для Claude Code и других агентов задаёт размеры виджетов и располагает их в интерфейсах Makepad 2.0. Покрывает вёрстку экранов и диагностику невидимых контейнеров. CX Codex +1 ★ 754звёзд репо

Из того же набора21

Весь набор →
improve-architecture Скилл improve-architecture для Claude Code разбирает архитектуру macOS-приложения на Swift и планирует безопасный рефакторинг. Срабатывает перед крупной функцией, в конце этапа или при повторяющихся проблемах в одной области. CX Codex +1 1 000установок app-brief Скилл app-brief для Claude Code и Cursor создаёт одностраничный файл docs/BRIEF.md для нового приложения под macOS до написания кода. CX Codex +1 1 000установок design-from-app Скилл design-from-app для Claude Code воссоздает дизайн любого приложения в виде нативной дизайн-системы SwiftUI по скриншотам. CX Codex +1 1 000установок os-integrations Скилл os-integrations для Claude Code помогает выбрать API macOS и нужные разрешения для системных функций приложения. Включается при добавлении глобальных горячих клавиш, захвата экрана или управления окнами других приложений. CX Codex +1 1 000установок user-stories Скилл user-stories для Claude Code, который превращает описание приложения в бэклог пользовательских историй с проверяемыми критериями. CX Codex +1 1 000установок swift-swiftui Скилл swift-swiftui для Claude Code задаёт правила Swift 6 и SwiftUI для приложений macOS. Подключается при написании, проверке и отладке Swift-кода, в том числе при ошибках конкуренции и Sendable. CX Codex +1 1 000установок design-kit Скилл design-kit для Claude Code и Cursor собирает дизайн-систему для macOS SwiftUI на токенах и компонентах. Включается, когда нужна своя тема интерфейса, фирменный стиль или библиотека элементов. CX Codex +1 1 000установок design-system Скилл design-system для Claude Code собирает дизайн-систему macOS-приложения из цветовых и интерфейсных токенов. Он подключается при настройке акцентного цвета, тем или общих правил для экранов. CX Codex +1 1 000установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой