dimensional-drawing README

README проекта с github.com/enesozturk/dimensional-drawing. Одним файлом markdown: README.md.

A dialog component's dimensional drawing drawing itself: header close-up, pull back to the plan view, layers lifting into an exploded view, then the full sheet

dimensional-drawing ✏️📐

Give it a UI component, get back a one-page technical drawing of it.
Paddings, gaps, corner radii, layers and viewport placement, measured and labeled like Apple's dimensional drawings.

Install · Use it · Make it move · Examples


Apple publishes dimensional drawings for every device so accessory makers can build cases that fit. They are calm, dense and beautiful: one sheet, a few views, tiny detail circles, numbers everywhere.

This repo teaches your agent to draw your components the same way. A card or a dialog becomes a spec sheet you could hand to anyone and they would rebuild its architecture: paddings, gaps, radii, layers, how it sits in the viewport. Copy and content are left out on purpose, so the drawing stays true when the text changes.

What's inside 🎁

skills/
├── dimensional-drawing/          the drawing skill
│   ├── SKILL.md
│   └── examples/                 card + dialog sheets (single HTML files)
└── dimensional-drawing-motion/   turns a sheet into a ~10 s film
    ├── SKILL.md
    ├── templates/                reference scene + stylesheet
    └── adapters/
        ├── claude-motion.md      Claude's Motion artifact (primary)
        └── headless/             Playwright + ffmpeg, no Claude needed

The house rules

⚫️ Monochrome grays only; things are told apart by line weight, dashes and hatches
🧱 Architecture, not content TITLE SLOT · FLEX, ACTION · HUG, CONTENT SLOT · FILL
🔤 Variables, not numbers S1, R2, H1 = 2·S1 + H3, R2 = R1 − B − S6
🏷️ Unbranded neutral names like UI-CARD-001
🙅 Never invent values unknowns stay [TBD]

Install

Claude Code

git clone https://github.com/enesozturk/dimensional-drawing
cp -r dimensional-drawing/skills/* ~/.claude/skills/

claude.ai / Claude desktop: zip a skill folder (for example skills/dimensional-drawing) and add it under Settings → Capabilities → Skills.

Any other agent (Codex, Cursor, Gemini CLI, …): use the skills CLI, or point your agent at the SKILL.md files.

npx skills add enesozturk/dimensional-drawing

Use it

Ask for a drawing and point at the source (a repo file, a Storybook story, a URL, a screenshot):

Make a dimensional drawing of the Card component in src/components/Card.tsx

Draw the anatomy of our settings dialog, same style as the examples

You get a title block with the key variables on top, then one dense sheet: notes, plan view, exploded layers, detail views (nested corner, radii, body), and variable tables.

It works for physical things too (third-angle views, mm, published specs only). Try a thermos 🫖.

Make it move 🎬

The motion skill animates a finished sheet like a pen drawing it while a camera moves over the paper:

  1. close-up on the header as its lines draw in
  2. pull back to the plan view while the rest draws
  3. layers lift off the plan into the exploded view (strokes first, fills after, so nothing flashes)
  4. pull back to the full sheet as the remaining views draw in

The scene is a pure function of time, so it runs in two places:

With Claude ask "animate this drawing". Claude builds it in the Motion artifact and you export MP4. This is the primary target and where the timing was tuned.
Without Claude cd skills/dimensional-drawing-motion/adapters/headless && npm install, then node render.mjs --scene ../../templates/scene-dialog.js --css ../../templates/base.css --out dialog.mp4. Needs Node 18+ and ffmpeg.

[!NOTE] Optimized for Claude Motion. The headless renderer is tested with Playwright (Chromium) + ffmpeg. Other animation libraries (Remotion, Motion Canvas, GSAP, Lottie…) are not tested.

Examples

Dialog: fixed width, scrim, viewport placement, header controls, footer actions

Dimensional drawing of a dialog component

Card: flexible width, body well, nested corner, shadow envelope

Dimensional drawing of a card component

Open the HTML versions in skills/dimensional-drawing/examples. The full film is assets/dialog-motion.mp4.

Thanks 💌

License

MIT © Enes Ozturk. Draw all the things.

dimensional-drawing (enesozturk/dimensional-drawing)

Ищем в базе…

Что это такое?Это навык Claude Agent Skill, который учит агента для программирования превращать UI-компонент в одностраничный технический чертёж, похожий на спецификации аксессуаров Apple. На чертеже показаны отступы, зазоры, радиусы скругления, слои и размещение во вьюпорте, а также подписи с измеренными значениями.
Это приложение, которое я запускаю, или навык, который я загружаю в агента для программирования?Это папка с навыком (файл SKILL.md), которую вы загружаете в агента, а не самостоятельная программа. В ней два навыка: основной навык для чертежей и навык анимации для оживления готового листа.
Что нужно помимо совместимого агента для программирования?Для построения чертежа компонента после загрузки навыка ничего дополнительно не нужно. Для рендеринга анимационного листа без Claude нужны Node 18+ и ffmpeg, чтобы запустить скрипт безголового рендерера.
Работает ли функция анимации с любым стеком рендеринга?Безголовый рендерер анимации протестирован только с Playwright (Chromium) и ffmpeg. Другие инструменты, такие как Remotion, Motion Canvas, GSAP или Lottie, не тестировались. Основная целевая платформа, под которую всё настроено, — Claude Motion.
Для кого предназначен этот навык?Для разработчиков и дизайнеров, которые хотят, чтобы их агент для программирования наглядно документировал архитектуру компонента (отступы, слои, радиусы), без брендинга и без утечки реальных текстов в чертёж.
На что на самом деле похож стиль чертежа?Он строго монохромный, в оттенках серого: элементы различаются только толщиной линий, штрихами и штриховкой. Объекты подписываются переменными, а не сырыми числами (например, S1, R2 = R1 − B − S6), и используются нейтральные безбрендовые имена вроде UI-CARD-001. Всё неизвестное помечается как [TBD], а не угадывается.
Может ли он рисовать физические объекты, а не только UI-компоненты?Да, он работает и с физическими предметами, используя виды по методу третьего угла и миллиметры, но только по опубликованным спецификациям, без выдуманных чисел.
Как анимировать готовый чертёж?С Claude достаточно попросить его анимировать чертёж, и он соберёт сцену в артефакте Motion для экспорта в MP4. Без Claude запустите безголовый рендерер на Node командой вида node render.mjs --scene scene-dialog.js --css base.css --out dialog.mp4.
Где посмотреть примеры результатов?HTML-примеры (Dialog и Card) находятся в skills/dimensional-drawing/examples, а полный отрендеренный фильм — в assets/dialog-motion.mp4.
Автор
enesozturk
Размер
17.4 MB
Звёзды
2.2K
Обновлён
КоммитOct 23
Возраст
26 д
Коммиты · 90 дней