Skip to content
Back to search

designlang

MarketplaceWorks with Claude CodeGitHubIncomplete

Safety scan

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

Checked today

Check it deeper on your machine

It has changed since its scan on 12 Nov 2026. Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Manavarya09/design-extract with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Manavarya09/design-extract'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/manavarya09-design-extract/badge.svg)](/listings/manavarya09-design-extract)

HTML

<a href="/listings/manavarya09-design-extract"><img src="/api/listings/manavarya09-design-extract/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

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

<p align="center"> </p>

npx designlang https://stripe.com                      # extract everything: tokens, Tailwind, shadcn, Figma, DESIGN.md
npx designlang slop https://yoursite.com               # how generic does it look? a score out of 100, with every tell
npx designlang verify-ui localhost:3000 --brand DESIGN.md  # check your UI against your brand at 390, 768 and 1280px
npx designlang mcp                                     # give Claude Code, Cursor and Windsurf your design system
npx designlang dna stripe.com                          # place it in the measured design space: neighbours + percentiles
npx designlang site stripe.com                         # whole-site: one canonical system + consistency grade
npx designlang fidelity stripe.com --clone localhost:3000  # score a clone against the original (visual + motion)
npx designlang studio                                  # live token editor: edit, preview, export, share
npx designlang brand stripe.com                        # full brand-guidelines book (13 chapters)
npx designlang pair stripe.com linear.app              # fuse two designs (visuals from A, voice from B)
npx designlang theme-swap stripe.com --primary "#ff4800"  # recolour around your brand
npx designlang pack stripe.com                         # one polished design-system directory
npx designlang remix stripe.com --as cyberpunk         # restyle in another vocabulary (--all for all six)
npx designlang grade https://stripe.com --badge        # report card + SVG badge
npx designlang battle stripe.com vercel.com            # head-to-head graded fight
npx designlang clone https://stripe.com                # working Next.js starter
npx designlang --full https://stripe.com               # screenshots + responsive + interactions

Needs Node.js 20 or later. No account, no API key.

Drop a live design-score badge in any README:

![Design Score](https://designlang.app/badge/stripe.com.svg)

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.

.claude-plugin/marketplace.json · Manifest · 39 lines
  1. {
  2. "name": "designlang",
  3. "owner": {
  4. "name": "Manavarya Singh",
  5. "url": "https://github.com/Manavarya09"
  6. },
  7. "plugins": [
  8. {
  9. "name": "designlang",
  10. "source": "./",
  11. "description": "Thirteen slash commands wrapping the designlang CLI: /extract (full design language → DTCG, Tailwind, Figma), /site (crawl a whole site → one canonical design system + consistency grade), /grade (shareable HTML report card + SVG badge), /battle (head-to-head graded comparison), /remix (restyle in 6 vocabularies — brutalist, swiss, art-deco, cyberpunk, soft-ui, editorial), /pack (one downloadable design-system bundle), /theme-swap (OKLCH-correct recolour around a new brand primary), /brand (full editorial brand-guidelines book — 13 chapters, hand-off-ready), /pair (fuse two designs across configurable axes — colours from one site, typography from another), /studio (live token-editor with component preview + export), /verify (rebuild from tokens and pixel-diff vs live for a fidelity score), /fidelity (score a clone vs the original — visual pixel-diff + motion fidelity — with a ranked correction plan), /gallery (build a shareable static gallery of measured clones).",
  12. "version": "13.4.1",
  13. "author": {
  14. "name": "Manavarya Singh"
  15. },
  16. "category": "design",
  17. "tags": [
  18. "design-system",
  19. "design-tokens",
  20. "dtcg",
  21. "tailwind",
  22. "shadcn",
  23. "figma",
  24. "typography",
  25. "colors",
  26. "motion",
  27. "grade",
  28. "battle",
  29. "remix",
  30. "pack",
  31. "site",
  32. "studio",
  33. "verify",
  34. "mcp",
  35. "playwright"
  36. ]
  37. }
  38. ]
  39. }
README.md · README · 573 lines
  1. <p align="center">
  2. <img src="./assets/art/banner.webp" alt="designlang: read any site’s design system, as tokens for Tailwind, Figma and your AI editor. npx designlang stripe.com" width="100%">
  3. </p>
  4. <p align="center">
  5. <a href="https://www.npmjs.com/package/designlang"><img src="https://img.shields.io/npm/v/designlang?color=0A0908&labelColor=F3F1EA&label=npm" alt="npm version"></a>
  6. <a href="https://github.com/Manavarya09/design-extract/blob/main/LICENSE"><img src="https://img.shields.io/github/license/Manavarya09/design-extract?color=0A0908&labelColor=F3F1EA" alt="license"></a>
  7. <a href="https://nodejs.org"><img src="https://img.shields.io/node/v/designlang?color=0A0908&labelColor=F3F1EA" alt="node version"></a>
  8. <a href="https://designlang.app/"><img src="https://img.shields.io/badge/website-live-FF4800?labelColor=F3F1EA" alt="website"></a>
  9. </p>
  10. <p align="center">
  11. <a href="https://trendshift.io/repositories/26231?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-26231" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/26231/daily?language=JavaScript" alt="Manavarya09%2Fdesign-extract | Trendshift" width="250" height="55"/></a>
  12. <a href="https://trendshift.io/repositories/26231?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-26231" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/26231/weekly?language=JavaScript" alt="Manavarya09%2Fdesign-extract | Trendshift" width="250" height="55"/></a>
  13. </p>
  14. <p align="center">
  15. Built by <a href="https://www.manavaryasingh.com">Manav Arya Singh</a> (<a href="https://github.com/Manavarya09">@Manavarya09</a>)
  16. </p>
  17. <p align="center">
  18. <img src="https://raw.githubusercontent.com/Manavarya09/design-extract/main/designlang.png" alt="designlang in action — extracts DTCG tokens, Tailwind config, Figma variables, brand book PDF" width="100%">
  19. </p>
  20. ## Sponsors
  21. <p align="center">
  22. <a href="https://www.atlascloud.ai/?utm_source=github&utm_medium=referral&utm_campaign=design-extract">
  23. <img src="./assets/atlas-cloud-logo.svg" alt="Atlas Cloud" width="220">
  24. </a>
  25. &nbsp;&nbsp;&nbsp;&nbsp;
  26. <a href="https://bloome.im/agent/join/XP8NQwFj?ref=9ZZRRy82">
  27. <img src="./assets/bloome.png" alt="Bloome" width="360">
  28. </a>
  29. </p>
  30. <p align="center">
  31. <strong><a href="https://www.atlascloud.ai/?utm_source=github&utm_medium=referral&utm_campaign=design-extract">Atlas Cloud</a></strong> — powers OpenAI-compatible <code>--smart</code> classification. For AI coding workflows, try the <a href="https://www.atlascloud.ai/console/coding-plan?utm_source=github&utm_medium=referral&utm_campaign=design-extract">Atlas Cloud coding plan</a>.
  32. <br>
  33. <strong><a href="https://bloome.im/agent/join/XP8NQwFj?ref=9ZZRRy82">Bloome</a></strong> — deploys your AI clone to handle every audience conversation, running in the cloud, 24/7.
  34. <br>
  35. Try designlang on <a href="https://bloome.im/agent/join/XP8NQwFj?ref=9ZZRRy82">Bloome</a>.
  36. </p>
  37. ---
  38. **designlang** points a headless browser at any URL and reads the design system off the live DOM. One command emits 17+ files — DTCG tokens, Tailwind config, shadcn theme, Figma variables, motion tokens, typed component anatomy, brand voice, page-intent labels, and a paste-ready prompt pack for v0 / Lovable / Cursor / Claude Artifacts.
  39. It also goes where extractors don't: **layout patterns**, **responsive behavior across 4 breakpoints**, **hover / focus / active states**, **WCAG contrast scoring**, **multi-page consistency**, **drift checks against a live source-of-truth**, **visual-diffs**, and a **shareable graded report card**.
  40. ## Quick start
  41. <p align="center">
  42. <img src="./assets/art/cli.webp" alt="Oil painting of a developer on a rooftop at night with a laptop" width="100%">
  43. </p>
  44. ```bash
  45. npx designlang https://stripe.com # extract everything: tokens, Tailwind, shadcn, Figma, DESIGN.md
  46. npx designlang slop https://yoursite.com # how generic does it look? a score out of 100, with every tell
  47. npx designlang verify-ui localhost:3000 --brand DESIGN.md # check your UI against your brand at 390, 768 and 1280px
  48. npx designlang mcp # give Claude Code, Cursor and Windsurf your design system
  49. npx designlang dna stripe.com # place it in the measured design space: neighbours + percentiles
  50. npx designlang site stripe.com # whole-site: one canonical system + consistency grade
  51. npx designlang fidelity stripe.com --clone localhost:3000 # score a clone against the original (visual + motion)
  52. npx designlang studio # live token editor: edit, preview, export, share
  53. npx designlang brand stripe.com # full brand-guidelines book (13 chapters)
  54. npx designlang pair stripe.com linear.app # fuse two designs (visuals from A, voice from B)
  55. npx designlang theme-swap stripe.com --primary "#ff4800" # recolour around your brand
  56. npx designlang pack stripe.com # one polished design-system directory
  57. npx designlang remix stripe.com --as cyberpunk # restyle in another vocabulary (--all for all six)
  58. npx designlang grade https://stripe.com --badge # report card + SVG badge
  59. npx designlang battle stripe.com vercel.com # head-to-head graded fight
  60. npx designlang clone https://stripe.com # working Next.js starter
  61. npx designlang --full https://stripe.com # screenshots + responsive + interactions
  62. ```
  63. Needs Node.js 20 or later. No account, no API key.
  64. Drop a live design-score badge in any README:
  65. ```markdown
  66. ![Design Score](https://designlang.app/badge/stripe.com.svg)
  67. ```
  68. ## Is it generic? (`slop`) and is it on brand? (`verify-ui`)
  69. `designlang slop <url>` opens the page in a real browser and scores how generic it looks, from 0 (distinct) to 100 (generic), listing each known AI-design tell it found with what was measured and where. Add `--brand DESIGN.md` to also score how close the page is to your brand. Try it in the browser at [designlang.app/slop](https://designlang.app/slop).
  70. `designlang verify-ui <url> --brand <DESIGN.md or tokens>` checks a screen, `localhost` included, at phone, tablet and desktop widths and in dark mode. It returns pass or fail, an on-brand score, and every drift with the expected and actual value. It exits 1 on drift, so it can gate CI. Your AI editor can run the same check itself through the MCP tool `verify_ui`.
  71. ## Watch it read — live Extraction Theatre (`v13`)
  72. <p align="center">
  73. <img src="./assets/art/showcase.webp" alt="Oil painting of tiny people carrying the colours, type and spacing off a giant web page" width="100%">
  74. </p>
  75. Don't take the output on faith — **watch it happen.** On
  76. [designlang.app/watch](https://designlang.app/watch) you paste a URL and a real
  77. headless Chromium opens the page and reads its entire design system in real
  78. time: a split stage with the live browser on the left and the design system —
  79. palette, type, spacing, motion — assembling itself on the right as each token
  80. lifts off the page.
  81. It's driven by the *actual* extraction (the browser's CDP screencast streamed
  82. frame-by-frame alongside the real token events), recorded so a shared link
  83. replays the exact run. No install, no account. Every gallery card can be watched
  84. the same way, and the [gallery](https://designlang.app/gallery) now spans **37
  85. real-graded design systems**.
  86. ## Whole-site design system (`site`)
  87. Most extractors read a single URL. `designlang site` crawls a site's canonical
  88. pages (home, pricing, docs, blog, about, product…) and synthesizes **one**
  89. de-duplicated system. Every token is elected by *coverage* — the share of pages
  90. that use it — so what's genuinely site-wide is separated from one-off,
  91. page-local choices. Near-identical colours are merged in OKLab. It's fully
  92. deterministic and free; no API key.
  93. ```bash
  94. npx designlang site stripe.com --max-pages 8
  95. ```
  96. You get, alongside the standard pack emitted from the **canonical** system:
  97. | File | What it is |
  98. |---|---|
  99. | `*-site-system.json` | canonical unified tokens + coverage + drift |
  100. | `*-site-coverage.md` | every token tagged 🟢 site-wide / 🟡 section / 🔴 page-local, with the pages using it |
  101. | `*-site-consistency.md` | a 0–100 consistency grade, per-category breakdown, and the off-system outliers to consolidate |
  102. ## Measured clone fidelity (`fidelity` + `gallery`)
  103. <p align="center">
  104. <img src="./assets/art/proof.webp" alt="Oil painting of eight framed website samples on a workbench, seven ticked off" width="100%">
  105. </p>
  106. Cloning tools all *claim* "pixel-perfect" — none of them **measure** it. `designlang
  107. fidelity` does. Point it at the original and your clone (often a local dev
  108. server) and it returns one honest number, both halves of the clone:
  109. - **Visual** — full-page screenshots of each, pixel-diffed.
  110. - **Motion** — `extractMotion()` on both, compared across feel, durations,
  111. easings, springs, keyframe kinds, scroll-linked motion, and choreography/
  112. stagger. (Most clones reproduce static pixels and drop the motion entirely;
  113. this is where they lose.)
  114. The two blend into a 0–100 score + letter grade, and — the part competitors
  115. don't ship — a **ranked correction plan**: the exact next edits that will raise
  116. the score, hardest-hitting first. Measure → fix → re-run until it converges.
  117. ```bash
  118. npx designlang fidelity https://stripe.com --clone http://localhost:3000
  119. npx designlang fidelity https://stripe.com --clone http://localhost:3000 --min 90 # CI gate
  120. ```
  121. Generating the clone with `designlang clone`? Add `--fidelity` and it grades the
  122. clone's token basis against the live site the moment it's built — writing
  123. `FIDELITY.md` + a correction plan straight into the project, no separate step:
  124. ```bash
  125. npx designlang clone https://stripe.com --fidelity
  126. ```
  127. You get `fidelity.md` (score + motion table + correction plan), `fidelity.json`,
  128. a shareable `fidelity-card.svg` (`88% · B · stripe.com`), and a `fidelity-diff.png`
  129. loss heatmap.
  130. Then publish them. `designlang gallery` scans your reports and builds a
  131. deployable static site — an index of score cards plus a permalink page per clone
  132. (each with an OG card, so a shared link unfurls the number).
  133. ```bash
  134. npx designlang gallery --title "Our clones" --base-url https://clones.example.com
  135. ```
  136. ## A measured design space (`dna`)
  137. Every extractor on the market answers *what* a design uses. None of them answers
  138. **where it sits**. `designlang grade` returns a letter — but a letter with no
  139. reference frame is a thermometer with no scale on it.
  140. `designlang dna` reduces a design to **30 deterministic features** across five
  141. axes — colour, type, space, shape, motion — and ranks it against a corpus of
  142. real design systems:
  143. ```bash
  144. npx designlang dna raycast.com
  145. ```
  146. ```
  147. Design DNA · https://raycast.com
  148. 30 features, 100% measurable
  149. vs 8 systems (default)
  150. color 65th percentile
  151. type 56th percentile
  152. space 42th percentile
  153. shape 79th percentile
  154. motion 67th percentile
  155. Nearest
  156. 0.14 https://railway.app
  157. 0.15 https://linear.app
  158. 0.19 https://notion.so
  159. ```
  160. Distance is the mean absolute difference across the features both designs have,
  161. so `0.14` reads as "the average feature is 14% of its range apart" — a number you
  162. can reason about, unlike a Euclidean distance in 30 dimensions.
  163. The report goes past similarity to **what makes a design look the way it does**:
  164. the features furthest from the middle of the corpus, in plain language
  165. (*"corner radius — 100th percentile, far above the corpus"*).
  166. Bring your own reference frame — your products, your competitors, a target look:
  167. ```bash
  168. npx designlang dna-corpus acme.com acme.com/pricing competitor.com
  169. npx designlang dna acme.com/new-page --corpus ./corpus.json
  170. ```
  171. Three things it refuses to do, because a design score that overclaims is worse
  172. than no score at all:
  173. - **A missing measurement stays missing.** Features the page never exposed are
  174. `null`, never a substituted midpoint, and distance skips them instead of
  175. comparing against an invented value.
  176. - **Every number carries its evidence.** Distances report how many features
  177. backed them, percentiles name the corpus and its size, and the report warns
  178. when coverage was partial.
  179. - **The space is versioned.** Feature order and normalization are frozen per
  180. vector version, and a corpus built by different rules is rejected rather than
  181. silently compared against.
  182. ## Install
  183. ```bash
  184. npm i -g designlang # global
  185. designlang install-browser # one-time: the Chromium designlang drives
  186. npx skills add Manavarya09/design-extract # as an agent skill (40+ agents)
  187. ```
  188. `npm install` no longer downloads a browser, so it works in CI, Docker and
  189. behind proxies. `install-browser` fetches the Chromium matching the bundled
  190. Playwright (add `--with-deps` on bare Linux). Without it, designlang falls back
  191. to an installed Google Chrome.
  192. ## Use in Claude Code (plugin)
  193. <p align="center">
  194. <img src="./assets/art/ai.webp" alt="Oil painting of a small robot at an easel copying a colour palette and type specimen" width="100%">
  195. </p>
  196. designlang ships as a **Claude Code plugin** — eleven slash commands that wrap
  197. the CLI. Install it from inside Claude Code:
  198. ```text
  199. /plugin marketplace add Manavarya09/design-extract
  200. /plugin install designlang@designlang
  201. ```
  202. The first command registers this repo as a plugin marketplace; the second
  203. installs the `designlang` plugin from it. Restart Claude Code if prompted, then
  204. the commands are available:
  205. | Command | What it does |
  206. |---|---|
  207. | `/extract <url>` | full design language → DTCG, Tailwind, Figma, motion, voice |
  208. | `/site <url>` | crawl a whole site → one canonical design system + consistency grade |
  209. | `/grade <url>` | shareable HTML report card + SVG badge |
  210. | `/battle <a> <b>` | head-to-head graded comparison |
  211. | `/remix <url> --as <vocab>` | restyle in 6 vocabularies (brutalist, swiss, art-deco, cyberpunk, soft-ui, editorial) |
  212. | `/pack <url>` | one downloadable design-system bundle |
  213. | `/theme-swap <url>` | OKLCH-correct recolour around a new brand primary |
  214. | `/brand <url>` | full editorial brand-guidelines book (13 chapters) |
  215. | `/pair <a> <b>` | fuse two designs across configurable axes |
  216. | `/studio` | live token editor — preview, dark mode, export, share |
  217. | `/verify <url>` | rebuild from tokens, pixel-diff vs live, fidelity score |
  218. | `/fidelity <url> --clone <url>` | score a clone vs the original (visual + motion) + correction plan |
  219. | `/gallery [dir]` | build a static shareable gallery of measured clones |
  220. | `/dna <url>` | place a design in the measured design space — nearest systems, per-axis percentiles, outliers |
  221. > Prefer raw MCP tools? The CLI ships an MCP server that extracts live URLs:
  222. >
  223. > ```bash
  224. > claude mcp add designlang -- npx -y designlang mcp
  225. > ```
  226. >
  227. > `extract_design(url)` returns a job id; poll `get_job_status`, then pass the
  228. > id to `get_tokens`, `get_colors`, `get_typography`, `get_components`,
  229. > `get_findings`, `compute_drift` (against a baseline job) or `export`
  230. > (dtcg, tailwind, shadcn, figma, css, design-md). Add `--output-dir <dir>` to
  231. > also serve an extraction already on disk as resources.
  232. ## Atlas Cloud for `--smart`
  233. `designlang --smart` can now use Atlas Cloud through its OpenAI-compatible chat API, so low-confidence classifiers can stay zero-dependency while routing to Atlas-hosted models.
  234. ```bash
  235. export ATLASCLOUD_API_KEY="<atlascloud-api-key>"
  236. export ATLASCLOUD_MODEL="deepseek-ai/deepseek-v4-pro"
  237. npx designlang https://stripe.com --smart
  238. ```
  239. - Atlas Cloud envs: `ATLASCLOUD_API_KEY`, `ATLASCLOUD_MODEL`, optional `ATLASCLOUD_API_BASE`
  240. - Alias envs also work: `ATLAS_CLOUD_API_KEY`, `ATLAS_CLOUD_MODEL`, `ATLAS_CLOUD_API_BASE`
  241. - Existing `OPENAI_API_KEY` and `ANTHROPIC_API_KEY` flows keep working unchanged
  242. ## What you get
  243. <p align="center">
  244. <img src="./assets/art/platforms.webp" alt="Oil painting of a river of violet paint flowing into a phone, tablet, laptop and watch" width="100%">
  245. </p>
  246. Each run writes 17+ files to `./design-extract-output/`. The headline outputs:
  247. | File | What it is |
  248. |---|---|
  249. | `*-design-language.md` | 19-section markdown — feed any LLM to recreate the design |
  250. | `*-design-tokens.json` | W3C DTCG tokens (primitive + semantic + composite layers) |
  251. | `*-tailwind.config.js` | Drop-in Tailwind theme |
  252. | `*-shadcn-theme.css` | shadcn/ui `globals.css` variables |
  253. | `*-figma-variables.json` | Figma Variables import (light + dark) |
  254. | `*-variables.css` | CSS custom properties |
  255. | `*-anatomy.tsx` | Typed React stubs for every detected component + variants |
  256. | `*-motion-tokens.json` | Durations, easings, springs, scroll-linked flag; with `--motion-runtime` also choreography (stagger) + scroll recipes + observed durations |
  257. | `*-voice.json` | Brand voice — tone, pronoun posture, CTA verbs |
  258. | `*-prompts/` | Paste-ready prompts for v0, Lovable, Cursor, Claude Artifacts |
  259. | `*-mcp.json` | Disk-backed MCP server payload |
  260. | `*-grade.html` | **v12.1** Shareable Design Report Card (letter grade + evidence) |
  261. | `*-grade.svg` | **v12.2** Shields.io-style design-score badge (drop into any README) |
  262. | `*-battle.html` | **v12.2** Head-to-head graded battle card from `designlang battle` |
  263. | `*-remix.<vocab>.html` | **v12.3** Site restyled in another vocabulary — brutalist / swiss / art-deco / cyberpunk / soft-ui / editorial |
  264. Multi-platform (`--platforms web,ios,android,flutter,wordpress,all`) adds `ios/`, `android/`, `flutter/`, and a WordPress block theme. `--emit-agent-rules` adds Cursor / Claude Code / generic agent rule files.
  265. ## Why designlang vs anything else
  266. <p align="center">
  267. <img src="./assets/art/compare.webp" alt="Oil painting of a brass scale weighing neat colour chips against grey scraps" width="100%">
  268. </p>
  269. Other tools give you the paint. designlang reads the architecture:
  270. - **Layout system** — grids, flex containers, container widths, gaps — not just tokens.
  271. - **Responsive** — crawls 4 breakpoints and reports what changes (`--responsive`).
  272. - **Interaction states** — programmatically hovers and focuses, captures the deltas (`--interactions`, `--deep-interact`).
  273. - **Motion language** — durations, easing families, spring detection, scroll-linked flag, `feel` fingerprint (springy / smooth / mechanical / mixed).
  274. - **Runtime motion (`--motion-runtime`)** — drives the page (load / scroll / hover / focus) and reads `document.getAnimations()` to capture what *actually* animates: real durations, **choreography/stagger** sequences, and **scroll recipes** (parallax / reveal / pin). Folded into `*-motion-tokens.json` and previewable live in the studio's Motion tab.
  275. - **Component anatomy** — slot trees with variant × size × state matrices, emitted as typed `.tsx`.
  276. - **Brand voice** — tone, pronoun posture, heading style, CTA verb inventory.
  277. - **Page intent + section roles** — `landing` / `pricing` / `docs` etc., with semantic regions (`hero`, `feature-grid`, `pricing-table`, `cta`…).
  278. - **Multi-page consistency** — auto-discovers canonical pages, reconciles shared vs per-route tokens.
  279. - **WCAG** — every fg/bg pair scored, with a remediation palette suggesting nearest passing colors.
  280. - **Drift + lint + visual-diff** — `designlang drift`, `lint`, `visual-diff` all CI-ready, exit non-zero on failure.
  281. - **Live-site sync** — treat the deployed site as source of truth (`designlang sync`).
  282. - **MCP server** — `designlang mcp` exposes tokens, regions, components, and contrast pairs to any MCP-aware agent.
  283. ```bash
  284. designlang grade https://stripe.com # ← v12.1: shareable report card
  285. designlang clone https://stripe.com # → working Next.js app
  286. designlang apply https://stripe.com -d ./app # auto-detect framework, write tokens
  287. designlang brands stripe.com vercel.com linear.app # N-brand matrix
  288. designlang drift https://yourapp.com --tokens ./src/tokens.json
  289. designlang lint ./src/tokens/design-tokens.json # CI-ready linter
  290. designlang visual-diff https://staging.app https://app # single-file HTML diff
  291. designlang mcp # stdio MCP server for Cursor / Claude Code
  292. designlang doctor # sanity-check the local install
  293. ```
  294. ## All features
  295. | Feature | Flag / Command | Description |
  296. |---------|---------------|-------------|
  297. | Base extraction | `designlang <url>` | Colors, typography, spacing, shadows, radii, CSS vars, breakpoints, animations, components |
  298. | Layout system | automatic | Grid patterns, flex usage, container widths, gap values |
  299. | Accessibility | automatic | WCAG 2.1 contrast ratios for all fg/bg pairs |
  300. | Design scoring | automatic | 7-category quality rating (A-F) with actionable issues |
  301. | Gradients | automatic | Gradient type, direction, stops, classification |
  302. | Z-index map | automatic | Layer hierarchy, z-index wars detection |
  303. | SVG icons | automatic | Deduplicated icons, size/style classification, color palette |
  304. | Font files | automatic | Source detection (Google/self-hosted/CDN/system), @font-face CSS |
  305. | Image styles | automatic | Aspect ratios, shapes, filters, pattern classification |
  306. | Dark mode | `--dark` | Extracts dark color scheme + light/dark diff |
  307. | Auth pages | `--cookie`, `--cookie-file`, `--header` | Extract from authenticated/protected pages; cookie files in JSON / Playwright storageState / Netscape formats |
  308. | Self-signed / dev TLS | `--insecure` | Ignore HTTPS/SSL certificate errors |
  309. | User-Agent override | `--user-agent <ua>` | Set a custom User-Agent string |
  310. | Chrome extension | `chrome-extension/` | One-click handoff from any tab, MV3, `activeTab` only |
  311. | Multi-page | `--depth <n>` | Crawl N internal pages; emits shared-vs-per-route token reconciliation (`*-tokens-shared.json`, `*-tokens-routes/<slug>.json`, `*-routes-report.md`) |
  312. | Screenshots | `--screenshots` | Capture buttons, cards, inputs, nav, hero, full page |
  313. | Responsive | `--responsive` | Crawl at 4 viewports, map breakpoint changes |
  314. | Interactions | `--interactions` | Capture hover/focus/active state transitions |
  315. | Auto-interact | `--deep-interact` | Scroll, open menus/modals/accordions, hover CTAs before extraction |
  316. | Runtime motion | `--motion-runtime` | Capture real motion via `document.getAnimations()` — durations, stagger/choreography, scroll recipes |
  317. | Everything | `--full` | Enable screenshots + responsive + interactions + deep-interact + motion-runtime |
  318. | Apply | `designlang apply <url>` | Auto-detect framework and write tokens to your project |
  319. | Clone | `designlang clone <url>` | Generate a working Next.js starter with extracted design |
  320. | Score | `designlang score <url>` | Rate design quality with visual bar chart breakdown |
  321. | Grade (v12.1) | `designlang grade <url>` | Shareable HTML "Design Report Card" — letter grade, 8 dimensions, evidence, strengths + fixes |
  322. | Battle (v12.2) | `designlang battle <A> <B>` | Head-to-head graded battle card with verdict, dimension table, palette comparison |
  323. | Badge (v12.2) | `designlang grade --badge` | Shields.io-style SVG badge — `design · B · 87` — drop into any README. Live endpoint: `designlang.app/badge/<host>.svg` |
  324. | Remix (v12.3) | `designlang remix <url> --as <vocab>` | Restyle the audited page in another vocabulary (brutalist / swiss / art-deco / cyberpunk / soft-ui / editorial). `--all` emits all 6 |
  325. | Pack (v12.4) | `designlang pack <url>` | Bundle every output (tokens / components / Storybook / starter / prompts) into one polished design-system directory |
  326. | Theme-swap (v12.6) | `designlang theme-swap <url> --primary <hex>` | Recolour the extracted design around a new brand primary. OKLCH hue rotation, neutrals preserved, type/spacing/motion untouched |
  327. | Brand book (v12.7) | `designlang brand <url>` | Full editorial brand-guidelines document (13 chapters: cover, about, logo, colour, type, spacing, shape, iconography, motion, components, voice, a11y, tokens, how-to-use). Print-ready, dark-mode toggle, hand-off-ready |
  328. | Pair (NEW v12.8) | `designlang pair <urlA> <urlB>` | Fuse two designs across 7 axes (colours/type/spacing/shape/motion/voice/components). Defaults to "visuals from A, voice + type from B". `--brand` also emits a brand book of the fused identity |
  329. | Design DNA (NEW v13.1) | `designlang dna <url>` | Reduce a design to a 30-feature vector (colour / type / space / shape / motion) and rank it against a corpus of real design systems — nearest neighbours, per-axis percentiles, outlier features |
  330. | DNA corpus (NEW v13.1) | `designlang dna-corpus <urls...>` | Build your own reference frame — your products, your competitors — for `dna` to measure against |
  331. | Watch | `designlang watch <url>` | Monitor for design changes on interval |
  332. | Diff | `designlang diff <A> <B>` | Compare two sites (MD + HTML) |
  333. | Multi-brand | `designlang brands <urls...>` | N-site comparison matrix |
  334. | Sync | `designlang sync <url>` | Update local tokens from live site |
  335. | History | `designlang history <url>` | Track design changes over time |
  336. | MCP server | `designlang mcp` | Expose extraction as MCP resources + tools |
  337. | Multi-platform | `--platforms <csv>` | Emit iOS / Android / Flutter / WordPress outputs |
  338. | Agent rules | `--emit-agent-rules` | Cursor, Claude Code, generic agent rule files |
  339. | Stack fingerprint | automatic | Framework + Tailwind + analytics detection |
  340. | CSS health | automatic | Specificity, !important, unused CSS, keyframes |
  341. | A11y remediation | automatic | Nearest palette color passing AA / AAA for every failing pair |
  342. | Semantic regions | automatic | nav / hero / pricing / testimonials / cta / footer classification |
  343. | Reusable components | automatic | DOM subtree + style-vector clustering with variants |
  344. | DTCG tokens | default | W3C Design Tokens v1 with semantic + composite layers (`--tokens-legacy` for pre-v7) |
  345. ## Full CLI Reference
  346. ```
  347. designlang <url> [options]
  348. Options:
  349. -o, --out <dir> Output directory (default: ./design-extract-output)
  350. -n, --name <name> Output file prefix (default: derived from URL)
  351. -w, --width <px> Viewport width (default: 1280)
  352. --height <px> Viewport height (default: 800)
  353. --wait <ms> Wait after page load for SPAs (default: 0)
  354. --dark Also extract dark mode styles
  355. --depth <n> Internal pages to crawl (default: 0)
  356. --screenshots Capture component screenshots
  357. --responsive Capture at multiple breakpoints
  358. --interactions Capture hover/focus/active states
  359. --deep-interact Auto-interact pass (scroll, menus, modals, accordions, hover CTAs)
  360. --motion-runtime Capture runtime motion via getAnimations() (durations, choreography, scroll recipes)
  361. --full Enable all captures (implies --deep-interact + --motion-runtime)
  362. --cookie <cookies...> Cookies for authenticated pages (name=value)
  363. --cookie-file <path> Load cookies from JSON / storageState / Netscape cookies.txt
  364. --header <headers...> Custom headers (name:value)
  365. --user-agent <ua> Override the browser User-Agent string
  366. --insecure Ignore HTTPS/SSL certificate errors (self-signed, dev, proxies)
  367. --selector <css> Only extract from elements matching this CSS selector (e.g. ".pricing-card")
  368. --system-chrome Use the system Chrome install instead of the bundled Chromium (skips 150MB download)
  369. --json Print full extraction as JSON to stdout (for piping into other tools)
  370. --framework <type> Only generate specific theme (react, shadcn)
  371. --platforms <csv> Additional platforms: web,ios,android,flutter,wordpress,all (additive)
  372. --emit-agent-rules Emit Cursor / Claude Code / CLAUDE.md / agents.md rule files
  373. --tokens-legacy Emit pre-v7 flat design-tokens.json shape (backward compat)
  374. --no-history Skip saving to history
  375. --verbose Detailed progress output
  376. Commands:
  377. apply <url> Extract and apply design directly to your project
  378. clone <url> Generate a working Next.js starter from extracted design
  379. score <url> Rate design quality (7 categories, A-F, bar chart)
  380. grade <url> Generate a shareable HTML Design Report Card (--format html|md|json|svg|all, --badge, --open)
  381. battle <urlA> <urlB> Head-to-head graded battle card (--format html|md|json|all, --open)
  382. remix <url> Restyle in another vocabulary (--as brutalist|swiss|art-deco|cyberpunk|soft-ui|editorial, --all, --list, --open)
  383. pack <url> Bundle every output into one design-system directory (--with-clone, --open)
  384. theme-swap <url> --primary <hex> Recolour around a new brand primary (--from, --format html|md|json|tokens|all, --open)
  385. brand <url> Generate a full editorial brand-guidelines book (--format html|md|json|all, --open)
  386. pair <urlA> <urlB> Fuse two designs across 7 axes (--colors-from, --typography-from, --spacing-from, --shape-from, --motion-from, --voice-from, --components-from, --brand)
  387. watch <url> Monitor for design changes on interval
  388. diff <urlA> <urlB> Compare two sites' design languages
  389. brands <urls...> Multi-brand comparison matrix
  390. sync <url> Sync local tokens with live site
  391. history <url> View design change history
  392. install-browser Download the Chromium designlang drives (--with-deps on bare Linux)
  393. mcp Launch stdio MCP server: extract live URLs as jobs (--output-dir <dir> also serves one on disk)
  394. lint <file> (v9) Audit a local token file (.json/.css) — CI-ready
  395. drift <url> --tokens <file> (v9) Check local tokens for drift against a live site
  396. visual-diff <before> <after> (v9) Side-by-side HTML diff of two URLs
  397. fidelity <original> --clone <url> Score a clone vs the original — visual pixel-diff + motion fidelity → one grade + ranked correction plan (--min, --motion-runtime)
  398. gallery [dir] Build a shareable static gallery of measured clones (--title, --base-url)
  399. ```
  400. ## Example output
  401. <p align="center">
  402. <img src="./assets/art/brandbook.webp" alt="Oil painting of a person on a park bench reading a book of colour palettes" width="100%">
  403. </p>
  404. `designlang https://vercel.com --full` →
  405. ```
  406. Colors: 27 · Fonts: Geist + Geist Mono · Spacing: 18 (base 2px)
  407. Shadows: 11 · Radii: 10 · CSS vars: 407 · Layout: 55 grids / 492 flex
  408. Responsive: 4 viewports, 3 breakpoint changes · Interactions: 8 transitions
  409. A11y: 94% WCAG · Score: 68/100 (D) · 4 issues
  410. → 17 files written to ./design-extract-output/
  411. → Run `designlang grade https://vercel.com` for a shareable report card
  412. ```
  413. ## How it works
  414. 1. **Crawl** — Headless Chromium via Playwright, waits for network idle and fonts
  415. 2. **Extract** — One `page.evaluate()` walks up to 5,000 DOM elements, collecting 25+ computed properties, inline SVGs, font sources, and image metadata
  416. 3. **Process** — 17 extractor modules parse, deduplicate, cluster, and classify the raw data
  417. 4. **Format** — 12+ formatter modules emit the output files
  418. 5. **Score** — Accessibility extractor calculates WCAG contrast ratios for all color pairs
  419. 6. **Capture** — Optional: screenshots, responsive viewport crawling, interaction state recording
  420. ## Install Everywhere
  421. designlang ships surfaces beyond the CLI:
  422. | Surface | Path | Description |
  423. |---------|------|-------------|
  424. | **CLI** | `npx designlang <url>` | Main entry point. |
  425. | **VS Code extension** | [`vscode-extension/`](vscode-extension/) | "Extract design from URL" command + auto-inject into workspace. |
  426. | **Raycast extension** | [`raycast-extension/`](raycast-extension/) | Extract, score, and "copy CLI command" from Raycast. |
  427. | **Figma plugin** | [`figma-plugin/`](figma-plugin/) | Paste a URL inside Figma, get a full Variables collection. |
  428. | **GitHub Action** | [`github-action/`](github-action/) | "Design regression guard" — diffs tokens on every PR and comments. |
  429. | **Chrome extension** | [`chrome-extension/`](chrome-extension/) | One-click handoff from any tab (MV3, `activeTab` only). |
  430. | **Doctor** | `designlang doctor` | One-screen health check of the local install — Node, playwright, Chromium binary, output dir, network. Exits `1` if anything fails. |
  431. | **MCP server** | `npx designlang mcp` | Exposes the extracted design as MCP resources + tools for Cursor, Claude Code, Windsurf, etc. See [`docs/MCP-REGISTRY.md`](docs/MCP-REGISTRY.md). |
  432. | **Claude Code plugin** | [`.claude-plugin/`](.claude-plugin/) | Five slash commands inside Claude Code — `/extract`, `/grade`, `/battle`, `/remix`, `/pack`. |
  433. ## Claude Code plugin
  434. Drop designlang straight into Claude Code as a plugin. Every CLI command becomes a slash command:
  435. ```bash
  436. /plugin install Manavarya09/design-extract
  437. ```
  438. Then inside any Claude Code session:
  439. | Slash command | What it does |
  440. |---|---|
  441. | `/extract <url>` | Full extraction → DTCG tokens, Tailwind, Figma vars, motion, voice |
  442. | `/grade <url>` | Shareable HTML "Design Report Card" (+ `--badge` for an SVG) |
  443. | `/battle <urlA> <urlB>` | Head-to-head graded battle card |
  444. | `/remix <url> --as <vocab>` | Restyle in brutalist / swiss / art-deco / cyberpunk / soft-ui / editorial |
  445. | `/pack <url>` | Bundle every output into one design-system directory |
  446. Manifest: [`.claude-plugin/plugin.json`](.claude-plugin/plugin.json) · marketplace: [`.claude-plugin/marketplace.json`](.claude-plugin/marketplace.json) · commands: [`commands/`](commands/) · skills: [`skills/`](skills/).
  447. ## Agent skill (other ecosystems)
  448. Works with **Cursor, Codex, and 40+ AI coding agents** via the skills ecosystem:
  449. ```bash
  450. npx skills add Manavarya09/design-extract
  451. ```
  452. In Cursor / Codex / etc., use `/extract-design <url>`.
  453. ## Contributing
  454. <p align="center">
  455. <img src="./assets/art/guides.webp" alt="Oil painting of a teacher at a board of colour swatches with three students" width="100%">
  456. </p>
  457. See [CONTRIBUTING.md](CONTRIBUTING.md). PRs welcome!
  458. ## License
  459. [MIT](LICENSE) - [Manav Arya Singh](https://www.manavaryasingh.com) !!

Ratings and comments

Sign in to rate this skill.

Sign in

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