Skip to content
Back to search

oa-design

The Open Analytics design language as an agent skill: component recipes with type-checked source, token CSS, and a CLI. Works with Claude Code, Cursor, or any agent.

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/openlabs-so--oa-design/badge.svg)](/listings/openlabs-so--oa-design)

HTML

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

Install

i

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

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

  1. # oa-design
  2. The design language of [Open Analytics](https://getopen.so), packaged three
  3. ways: an agent skill, type-checked component recipes, and a CLI. People kept
  4. asking how the dashboard looks and moves the way it does; this repository is
  5. the answer, in a form an agent can execute. Every hex code, spring constant,
  6. radius and easing is lifted from the shipped product, with the reasoning
  7. attached.
  8. The look in one sentence: **white surfaces with continuous-curvature corners,
  9. resting on a quiet grey stage, drawn in a single ink, moved by a single
  10. spring.**
  11. ## Get it
  12. **CLI** (recipes into your project, shadcn-style):
  13. ```sh
  14. npx getopen-design list # what's available
  15. npx getopen-design add tab-bar toast # recipes into ./oa-design
  16. npx getopen-design add --all --code # everything, .tsx source included
  17. npx getopen-design tokens # just the token CSS
  18. npx getopen-design skill # agent skill into .claude/skills
  19. ```
  20. **Claude Code**, without the CLI:
  21. ```sh
  22. git clone https://github.com/OpenLabs-so/oa-design
  23. cp -r oa-design/skills/oa-design .claude/skills/oa-design
  24. ```
  25. **Any other agent** (Cursor, Codex, plain chat): grab
  26. [`DESIGN-SKILL.md`](DESIGN-SKILL.md), the whole language compiled into one
  27. file, and point your rules at it:
  28. ```
  29. When building or styling UI, follow DESIGN-SKILL.md in full.
  30. ```
  31. ## What's in the box
  32. ```
  33. skills/oa-design/ the agent skill
  34. ├── SKILL.md ten rules, the spring table, the index
  35. ├── _root.css the installable token block everything reads from
  36. ├── 01…12-*.md one recipe per component, full source embedded
  37. └── _*.md guides: tokens, layout, components, motion, landing, copy
  38. components/ the type-checked source the recipes embed
  39. ├── _lib/ cn + the seven springs as constants
  40. └── <slug>/ squircle-card, button, dropdown, tab-bar, modal,
  41. multi-step-dialog, skeleton, notice-strip,
  42. floating-pill, toast, header-morph, reveal
  43. cli/ the getopen-design npm package
  44. DESIGN-SKILL.md everything in one file, for pasting
  45. ```
  46. The recipes are the consumer format and they are never written by hand:
  47. `node build/sync.mjs` injects the compiled source from `components/` into
  48. each recipe (and `--cli` mirrors the payload into the npm package), so the
  49. code in the MDs is exactly the code `npm run typecheck` passes.
  50. ## What's inside the language
  51. - One ink, every neutral derived from it by `color-mix` percentages.
  52. - The squircle surface system (CSS `shape()` clip-path, both layers, exact
  53. radii) behind the cards.
  54. - A seven-spring motion vocabulary covering the entire product, plus the
  55. signature moves: the measured-height dialog choreography, the tab bar's
  56. label mask, the landing header's glass morph, the blur skeleton arrival.
  57. - Layout as plates, fixed-height card grids, the notice and floating-pill
  58. patterns, toast physics.
  59. - The copy voice, because half the design is the words.
  60. - The quality floor: focus rings, reduced motion, no sideways scroll.
  61. ## What this is not
  62. Not a component library and not a theme package: nothing here depends on us
  63. at runtime. The values were written against React + Tailwind v4 +
  64. [`motion`](https://motion.dev), but they are plain CSS numbers and spring
  65. constants; port them anywhere. If your project already has a design system,
  66. yours wins; use this to fill gaps.
  67. ## Credits
  68. - Built from the shipped UI of [Open Analytics](https://getopen.so), which is
  69. itself [open source](https://github.com/OpenLabs-so/openanalytics).
  70. - The repository shape (recipes + skill + CLI from one source) follows
  71. [Jakub Antalik's transitions.dev](https://github.com/Jakubantalik/transitions.dev),
  72. which also inspired our skeleton blur arrival. Thank you.
  73. ## License
  74. MIT. Use it, ship it, sell what you build with it. A link back is
  75. appreciated but not required.

Ratings and comments

Sign in to rate this skill.

Sign in

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