Skip to content
Back to search

design-intelligence

MarketplaceWorks with Claude CodeGitHub

RYUX: design intelligence backed by real product screens, for the AI agents that build and the designers who review.

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 11 Nov 2026.

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/ryuxdsgn/design-intelligence 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/ryuxdsgn/design-intelligence'

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/ryuxdsgn--design-intelligence/badge.svg)](/listings/ryuxdsgn--design-intelligence)

HTML

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

Install

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 · 14 lines

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

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "design-intelligence",
  3. "description": "RYUX: design intelligence backed by real product screens, for the AI agents that build and the designers who review.",
  4. "owner": {
  5. "name": "ryuxdsgn"
  6. },
  7. "plugins": [
  8. {
  9. "name": "ryux",
  10. "source": "./plugins/ryux",
  11. "description": "RYUX, design intelligence for AI agents and designers: one skill with five entry points. Analyze an existing interface, Design without code, Build in your stack, Critique a Figma link, pen.dev design, website URL, or screenshot, and QA the result. RYUX reads only the knowledge each task needs."
  12. }
  13. ]
  14. }
README.md · README · 202 lines

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

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <a href="https://www.npmjs.com/package/@ryuxdsgn/design-intelligence"><img src="https://img.shields.io/npm/v/@ryuxdsgn/design-intelligence?label=npm&color=B9A8FF&labelColor=1E232B" alt="npm version"></a>
  3. <a href="#use-it"><img src="https://img.shields.io/badge/works%20with-Claude%20Code%20%C2%B7%20Codex%20%C2%B7%20Cursor%20%C2%B7%20Gemini%20CLI%20%C2%B7%20%2B6-C8F25A?labelColor=1E232B" alt="Works with Claude Code, Codex, Cursor, Gemini CLI, and 6 more agents"></a>
  4. <a href="https://github.com/ryuxdsgn/design-intelligence/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/ryuxdsgn/design-intelligence/ci.yml?branch=main&label=CI&labelColor=1E232B" alt="CI"></a>
  5. <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-F6F1E7?labelColor=1E232B" alt="MIT License"></a>
  6. </p>
  7. <h1>
  8. <picture>
  9. <source media="(prefers-reduced-motion: reduce)" srcset="https://github.com/ryuxdsgn/design-intelligence/releases/download/media/readme--ryux-banner-still.png">
  10. <img src="https://github.com/ryuxdsgn/design-intelligence/releases/download/media/readme--ryux-banner.gif" width="100%" alt="RYUX. Pixel-art office. A product owner gives an AI agent a task; the agent rushes it, and the owner reads each draft, crumples it, and throws it in the bin, three times. The owner installs RYUX, and a RYUX designer drops in. Now the agent asks first, sketches the wireframe on a board with RYUX, and ticks off a checklist. The owner reads the finished work, has a light-bulb moment, and everyone cheers as a flag goes up.">
  11. </picture>
  12. </h1>
  13. ### Understand before you design.
  14. A design skill for AI agents. Your agent asks about the product before it designs, keeps what it does not know
  15. out of the screens instead of inventing fees, promos, and policies, designs for when things go wrong, and
  16. explains each decision.
  17. ```bash
  18. npx @ryuxdsgn/design-intelligence
  19. ```
  20. Works with Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode, Cline, Amp, Kimi Code, and
  21. Antigravity. Free, MIT.
  22. Given a one-line brief for an order-tracking prototype, agents without a skill made up 28 business rules across three
  23. runs and showed them as fact: refund times, a $4.99 cancellation fee, courier ratings, a late-delivery guarantee. With
  24. RYUX: 1, counted blind ([order tracking benchmark](docs/benchmarks/order-tracking/)).
  25. ## No skill vs RYUX
  26. Same short brief, same agent (Claude Code), one side with RYUX. Quotes are the agent's own words from that run;
  27. scores are blind ratings, 1 to 5, by a senior designer who didn't know which side used RYUX. The principles the callouts name
  28. (Fitts, Hick, Gestalt, Nielsen's heuristics, WCAG) and the rules built on them are listed in
  29. [Design principles](docs/principles.md).
  30. **Checkout, from one sentence.** The brief names the product (Sejuk, an iOS app for booking an AC technician in
  31. Jakarta) and nothing else. Without a skill, the agent filled the gaps with a price, fees, a promo code, a warranty, and a
  32. cancellation rule. The RYUX run asked first: which direction, how the price is set, how people pay, what the screen may
  33. promise. Told to go with its recommended direction, it took its other recommendations as assumptions, labelled the
  34. price and payment as not decided, left out fees and promises, and built five states.
  35. <img src="https://github.com/ryuxdsgn/design-intelligence/releases/download/media/showcase--h2h-1-checkout.jpg" alt="Two checkout screens for Sejuk. No skill: a light grey iOS list with an invented per-unit price, what each unit includes, a 90-minute duration, a GoPay balance, promo SEJUKHEMAT, transport and service fees, a 30-day cooling warranty, and free cancellation until 11:00; red boxes mark 9 of them. RYUX: a deep teal header with a sawtooth trim from Betawi roof eaves, the units stepper beside the price, a 'Sample price. Per-unit pricing not decided' label, QRIS preselected, and one Pay with QRIS button; two red boxes mark a unit type and an arrival window the brief did not give. Five quotes from the RYUX run's Figma annotations and final message explain the choices." width="100%">
  36. Blind rating: 4.33 with RYUX, 2.83 without; honesty 5 v 1, states 5 v 1, visual direction 4 v 2. The screen
  37. without a skill fit the AC service better (5 v 4), and copy tied (4 v 4). [Checkout benchmark](docs/benchmarks/checkout/)
  38. **Illustration.** Asked for the service icons, an empty state, and a success screen, the RYUX run built one system from
  39. the product: the same AC unit in every icon, no steam that would read as heat, a technician on a motorbike as in Jakarta.
  40. The brief asked for Indonesian copy; for this image it was translated to English the same way on both sides, and the art
  41. is unchanged.
  42. <img src="https://github.com/ryuxdsgn/design-intelligence/releases/download/media/showcase--h2h-2-illustration.jpg" alt="Three app screens per side for Sejuk, an AC service app. No skill: flat line icons, a clipboard empty state, and a success screen that names a technician, Pak Budi, with an arrival time of 2:30 PM and a contact button. RYUX: soft clay-style icons of one AC unit with water spray, a gauge, and a wrench; a blank clipboard with a remote; a technician on a motorbike riding to an apartment block. Three numbered quotes from the RYUX run explain the choices." width="100%">
  43. Blind rating of these two runs: 4.06 with RYUX, 3.06 without; over both runs per side, 3.97 v 3.00
  44. ([illustration benchmark](docs/benchmarks/illustration/#rerun-with-the-fix-pr-36-released-in-2226)).
  45. **Motion, in a clickable prototype.** Asked for a booking flow with motion for each step, the RYUX run asked about
  46. price, payment, and rules first. With its defaults agreed, it labelled the price as an estimate, showed no fee or
  47. cancellation policy, and gave each movement a job: a slide for a step deeper, visible progress while booking, a fade
  48. for the finished booking.
  49. <img src="https://github.com/ryuxdsgn/design-intelligence/releases/download/media/showcase--h2h-3-motion.gif" alt="Two booking prototypes for Sejuk, recorded along the same path: pick a time slot, review, confirm. No skill: an iOS-blue flow that assigns a rated technician before booking, shows '1 slot left', and ends on 'You're booked!'. RYUX: a teal flow that starts from the request, slides to the time list, shows 'Booking…' with a spinner, and ends on 'Booking confirmed' with airflow lines around the check. Three quotes from the RYUX run explain its motion." width="100%">
  50. Blind rating from the recordings: 3.83 with RYUX, 3.00 without; honesty 4 v 2, visual direction 4 v 2,
  51. motion 4 v 3. Craft tied at 3: in both, the button label overlaps during the confirm transition.
  52. [Motion benchmark](docs/benchmarks/motion/)
  53. **Direction, before the first screen.** Same one-sentence checkout brief. Without a skill, the agent drew one screen;
  54. its only line on visual direction was about colour. The RYUX run first offered three directions drawn from the product
  55. and its city, each with its risk, then built the checkout in the one it recommended, with every undecided price and
  56. rule in Figma annotations rather than on the screen.
  57. <img src="https://github.com/ryuxdsgn/design-intelligence/releases/download/media/showcase--h2h-4-direction.jpg" alt="No skill: a light grey iOS checkout for Sejuk, with its only line on visual direction quoted: the colors are a cool teal, with green used only for savings. RYUX: a page offering three directions for the Sejuk checkout, Mega Mendung (Cirebon batik rain clouds in five blues, recommended), Cool Down (a warm-to-cool temperature line), and The Remote (a dark AC-remote look with an LCD readout), each with palette, type, sample card, and risk; next to it, the checkout built in Mega Mendung with a deep indigo cloud band in the header only. Four quotes from the RYUX run explain the choices." width="100%">
  58. Not rated: a later RYUX run with the same brief, set against the no-skill run above.
  59. [Checkout benchmark](docs/benchmarks/checkout/#later-run-direction-and-annotations)
  60. ## Use it
  61. Say what you are doing, in your own words. RYUX picks the step and reads only the knowledge it needs.
  62. | You say | RYUX runs | You get |
  63. | --- | --- | --- |
  64. | "Analyze this checkout screen" (screenshot attached) | **Analyze** | what is there, what is measured, what is only inferred |
  65. | "Redesign this screen in our Figma file" | **Design** | the file's own libraries read as the design system, directions you pick from in the browser, then the screens and their states |
  66. | "Write our DESIGN.md from this brief, or from our Figma file" | **Design** | a DESIGN.md that says who the users are, their job, the evidence, the patterns that fit, and how to evaluate; from a design file, every token and component is read from the file itself, as a per-state matrix a build can use; unknowns listed, not invented |
  67. | "Build this design in our React app" | **Build** | the code, without invented rules, data, or API behavior |
  68. | "Critique our pricing page at https://example.com/pricing" | **Critique** | what to change first, with severity, evidence, and a fix |
  69. | "QA the build against the design at 390 and 320 wide" | **QA** | a check of every width and state against the design |
  70. Every task ends with a report of what was verified and what was not. The installer also offers a short setup
  71. that writes DESIGN.md, your project's direction (`npx @ryuxdsgn/design-intelligence setup` to change it).
  72. <details>
  73. <summary><b>Scan your code</b></summary>
  74. `scan` checks what a machine can see, with no LLM and no API key. A fail exits 1, so it works in CI.
  75. ```text
  76. $ npx @ryuxdsgn/design-intelligence scan src
  77. ✗ src/Checkout.tsx:4:7 RX-A11Y-04 an <img> with no alt: describe meaningful images, use alt="" for decorative ones
  78. ✗ src/Checkout.tsx:5:16 RX-CD-02 "Rp 50.000": write Rp1.250.000 (Rp right before the number, dots for thousands, no decimals)
  79. ! src/Checkout.tsx:6:10 RX-AS-04 "Only 2 left": urgency copy; keep it only when the deadline or quota is real, stated as a plain fact
  80. ! src/Checkout.tsx:7:7 RX-A11Y-04 an icon-only <button> with no name: add aria-label or visually hidden text
  81. 1 file scanned: 2 fail, 2 warn.
  82. ```
  83. Give it a URL and it renders the page at 320, 390, and 1280 px and measures sideways scroll, contrast, target
  84. size, and colliding text (Playwright in your project):
  85. ```text
  86. $ npx @ryuxdsgn/design-intelligence scan file://$PWD/page.html --widths 320
  87. ✗ file:///…/page.html @320px RX-RD-01 the page scrolls sideways: 480px of content in 320px; widest: div.promo (to 480px) [div.promo]
  88. ✗ file:///…/page.html @320px RX-A11Y-01 "Transfers usually arrive in minutes.": contrast 2.32:1 (#aaaaaa on #ffffff), needs 4.5:1 [p.hint]
  89. ```
  90. Add `--hook` to `install` and the agent gets the findings for each file it edits. Any finding, warn included,
  91. goes back to the agent, which fixes it or adds a `ryux-ignore` comment with the reason. This works for Claude Code
  92. (exit 2), Codex and Cursor (both as context next to the edit's result), and OpenCode (a plugin in
  93. `.opencode/plugins/`, added to the edit's result). Codex runs a project hook only after you trust the project and
  94. approve the hook in `/hooks`. A plain `scan` fails (exit 1) only on a fail. `scan --list-rules`
  95. lists every check.
  96. </details>
  97. <details>
  98. <summary><b>Other ways to install</b></summary>
  99. - [skills.sh](https://skills.sh): `npx skills add ryuxdsgn/design-intelligence`
  100. - Claude Code plugin: `/plugin marketplace add ryuxdsgn/design-intelligence`, then
  101. `/plugin install ryux@design-intelligence`
  102. - Plugins for Codex, GitHub Copilot, VS Code, and Gemini CLI, global installs, and updates: see the
  103. [guide](GUIDE.md).
  104. </details>
  105. <details>
  106. <summary><b>Benchmarks: where RYUX helps, and where it doesn't</b></summary>
  107. Each benchmark compares the same brief with no skill and with RYUX. Criteria were locked before the first run, and
  108. every run starts with a fresh agent. The head-to-heads above are one run per side; the three below are 2 to 3 per
  109. side. These numbers describe these runs, not rates.
  110. **Order tracking (code): pass.** Policies the brief left open were shown as fact 28 times in the
  111. [no-skill runs](docs/benchmarks/order-tracking/) and once with RYUX. Offline, loading, and error states appeared in
  112. every RYUX run and in none of the no-skill runs. Every RYUX run asked before building.
  113. **Landing page (Figma): pass.** A senior designer rated the [pages](docs/benchmarks/landing-gold/) blind. RYUX scored higher
  114. on originality (4.0 v 2.0), on AI-slop resistance (3.5 v 2.0), and overall (3.69 v 3.19). It scored lower on
  115. production plausibility: sample-data labels and logo slots showed on the design.
  116. **Illustration (Figma): fail.** In the [illustration benchmark](docs/benchmarks/illustration/), RYUX lost on concept,
  117. craft, and fit at real size (3.30 v 3.73). It led only on cohesion. A fix, now released, passed a rerun (3.97 v 3.00).
  118. **Cost:** a RYUX run costs more, about 1.5 to 7 times a run without a skill in these benchmarks; it asks first,
  119. checks states, and writes its rationale.
  120. Setup, raw outputs, and how to run one yourself: [`docs/benchmarks/`](docs/benchmarks/).
  121. </details>
  122. <details>
  123. <summary><b>What gets installed, and the repository</b></summary>
  124. One skill folder, `ryux/`: a router (`SKILL.md`) that picks the step, five capability files, and the knowledge
  125. modules those steps read. Behind every step runs one workflow: understand, frame the problem, explore two or
  126. three alternatives, evaluate them against the brief (you pick), build and critique, then verify. Rules have
  127. levels (Required, Preferred, Contextual) and a few Hard Gates that are never waived, such as no invented
  128. numbers and no missing critical states. Browse them in [`skills/ryux/`](./skills/ryux) and
  129. [`docs/design-rules.md`](./docs/design-rules.md), and the principles behind them in
  130. [`docs/principles.md`](./docs/principles.md).
  131. ```
  132. packages/cli/ the ryux CLI (npx @ryuxdsgn/design-intelligence)
  133. skills/ryux/ the RYUX skill, generated from packages/cli/src
  134. docs/ design rules, benchmarks
  135. ```
  136. ```bash
  137. pnpm install && pnpm typecheck && pnpm test
  138. ```
  139. Issues and pull requests are welcome; start with [CONTRIBUTING.md](./CONTRIBUTING.md). Rules and skills are generated from `packages/cli/src`; run
  140. `pnpm sync:skills` after changing them. Designers who want to rate the next blind round: open an issue. To
  141. report a vulnerability, see [SECURITY.md](./SECURITY.md).
  142. </details>
  143. ## Status and license
  144. Early access. Available now: the skill, the CLI with `scan`, skills.sh, and the Claude Code
  145. plugin. In early access: an optional MCP with reference screens from real products (a key per person, a small
  146. library so far). RYUX works fully without it; the reference data is private and not in this repository.
  147. **MIT**, © 2026 ryux.design (see [LICENSE](./LICENSE)). The code and the RYUX skill are covered by this
  148. license; the reference data and the hosted service are separate. Assets in this repository are synthetic
  149. outputs and illustrations created for RYUX experiments and its website, unless otherwise noted. Brand names may
  150. appear as text in mock interfaces and do not indicate affiliation.

Ratings and comments

Sign in to rate this skill.

Sign in

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