Skip to content
Back to search

dimensional-drawing

Create Apple style dimensional drawings of UI components.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/enesozturk--dimensional-drawing/badge.svg)](/listings/enesozturk--dimensional-drawing)

HTML

<a href="/listings/enesozturk--dimensional-drawing"><img src="/api/listings/enesozturk--dimensional-drawing/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**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`](https://skills.sh) CLI, or point your agent at the `SKILL.md` files.

npx skills add enesozturk/dimensional-drawing

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 117 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="assets/dialog-motion.gif" alt="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" width="100%">
  3. </p>
  4. <h1 align="center">dimensional-drawing ✏️📐</h1>
  5. <p align="center">
  6. <b>Give it a UI component, get back a one-page technical drawing of it.</b><br>
  7. Paddings, gaps, corner radii, layers and viewport placement, measured and labeled like Apple's dimensional drawings.
  8. </p>
  9. <p align="center">
  10. <a href="#install">Install</a> ·
  11. <a href="#use-it">Use it</a> ·
  12. <a href="#make-it-move">Make it move</a> ·
  13. <a href="#examples">Examples</a>
  14. </p>
  15. ---
  16. Apple publishes [dimensional drawings](https://developer.apple.com/accessories/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.
  17. 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.
  18. ## What's inside 🎁
  19. ```
  20. skills/
  21. ├── dimensional-drawing/ the drawing skill
  22. │ ├── SKILL.md
  23. │ └── examples/ card + dialog sheets (single HTML files)
  24. └── dimensional-drawing-motion/ turns a sheet into a ~10 s film
  25. ├── SKILL.md
  26. ├── templates/ reference scene + stylesheet
  27. └── adapters/
  28. ├── claude-motion.md Claude's Motion artifact (primary)
  29. └── headless/ Playwright + ffmpeg, no Claude needed
  30. ```
  31. ### The house rules
  32. | | |
  33. |---|---|
  34. | ⚫️ **Monochrome** | grays only; things are told apart by line weight, dashes and hatches |
  35. | 🧱 **Architecture, not content** | `TITLE SLOT · FLEX`, `ACTION · HUG`, `CONTENT SLOT · FILL` |
  36. | 🔤 **Variables, not numbers** | `S1`, `R2`, `H1 = 2·S1 + H3`, `R2 = R1 − B − S6` |
  37. | 🏷️ **Unbranded** | neutral names like `UI-CARD-001` |
  38. | 🙅 **Never invent values** | unknowns stay `[TBD]` |
  39. ## Install
  40. **Claude Code**
  41. ```bash
  42. git clone https://github.com/enesozturk/dimensional-drawing
  43. cp -r dimensional-drawing/skills/* ~/.claude/skills/
  44. ```
  45. **claude.ai / Claude desktop:** zip a skill folder (for example `skills/dimensional-drawing`) and add it under *Settings → Capabilities → Skills*.
  46. **Any other agent** (Codex, Cursor, Gemini CLI, …): use the [`skills`](https://skills.sh) CLI, or point your agent at the `SKILL.md` files.
  47. ```bash
  48. npx skills add enesozturk/dimensional-drawing
  49. ```
  50. ## Use it
  51. Ask for a drawing and point at the source (a repo file, a Storybook story, a URL, a screenshot):
  52. > Make a dimensional drawing of the `Card` component in `src/components/Card.tsx`
  53. > Draw the anatomy of our settings dialog, same style as the examples
  54. 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.
  55. It works for physical things too (third-angle views, mm, published specs only). Try a thermos 🫖.
  56. ## Make it move 🎬
  57. The motion skill animates a finished sheet like a pen drawing it while a camera moves over the paper:
  58. 1. close-up on the header as its lines draw in
  59. 2. pull back to the plan view while the rest draws
  60. 3. layers lift off the plan into the exploded view (strokes first, fills after, so nothing flashes)
  61. 4. pull back to the full sheet as the remaining views draw in
  62. The scene is a pure function of time, so it runs in two places:
  63. | | |
  64. |---|---|
  65. | **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. |
  66. | **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. |
  67. > [!NOTE]
  68. > Optimized for Claude Motion. The headless renderer is tested with Playwright (Chromium) + ffmpeg. Other animation libraries (Remotion, Motion Canvas, GSAP, Lottie…) are **not tested**.
  69. ## Examples
  70. **Dialog**: fixed width, scrim, viewport placement, header controls, footer actions
  71. <img src="assets/dialog-sheet.png" alt="Dimensional drawing of a dialog component" width="100%">
  72. **Card**: flexible width, body well, nested corner, shadow envelope
  73. <img src="assets/card-sheet.png" alt="Dimensional drawing of a card component" width="100%">
  74. Open the HTML versions in [`skills/dimensional-drawing/examples`](skills/dimensional-drawing/examples). The full film is [`assets/dialog-motion.mp4`](assets/dialog-motion.mp4).
  75. ## Thanks 💌
  76. - [Apple's accessory dimensional drawings](https://developer.apple.com/accessories/dimensional-drawings/), the north star
  77. - [Andreas Storm](https://x.com/avstorm), whose post started this
  78. ## License
  79. MIT © Enes Ozturk. Draw all the things.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.