Answer in brief
shadcn/ui scores 7 of 8 and shares fifth place on the ranking. Its agent tooling is strong: an official MCP server that finds and installs components, an llms.txt with a Markdown copy of every page, and a skill. It loses 1 point on design tokens, because its theme is CSS variables and no design token file is documented for programs to read.
Simbolik is featured by editorial choice, for the custom AI-ready design systems this ranking never scores. Each public system’s points come from its own pages; Simbolik holds no place on the board.
Its score on the board
shadcn/ui scores 7 of 8 and shares fifth place with Chakra UI and Shopify Polaris. The ratings come from its own docs and repository, and it has no tie to Simbolik. It is not a package you install and call; it is source code you copy, which shapes both its strengths and its one lost point.
The 5 signs and their proof
The first 4 signs make the score out of 8: 2 points for a Yes, 1 for a Partly, none for a No. Typed props are rated beside them and left out of the score.
- Design tokens: Partly, 1 point. The theme is CSS variables such as
--backgroundand--primary. Color values are also served as JSON under/r/colors/, but no page documents them as a design token feed, and there is no file in the W3C format or package of design tokens. Proof: shadcn/ui, theming (opens in a new tab), checked November 8, 2026. - Agent access: Yes, 2 points.
npx shadcn@latest mcpstarts the official server, which browses, searches and installs components from registries, and registry owners get it for their own components at no cost. Proof: shadcn/ui, MCP server (opens in a new tab), checked November 8, 2026. - Docs: Yes, 2 points. An llms.txt, and every page as Markdown when you add
.md. There is no llms-full.txt. Proof: shadcn/ui’s llms.txt (opens in a new tab), checked November 8, 2026. - Guidance: Yes, 2 points.
npx skills add shadcn/uiinstalls a skill that reads yourcomponents.json, runsshadcn info --jsonand has rules for the CLI and for customizing. Proof: shadcn/ui, skills (opens in a new tab), checked November 8, 2026. - Typed props: Yes, not scored. Components are TypeScript files copied into your project, and each docs page has an API reference of props such as variant and size. Proof: Button, as Markdown (opens in a new tab), checked November 8, 2026.
What it suits
Teams that want to own their component code and let agents install, read and change it. Because the source lands in your repository, an agent works on files it can open, and your changes are never overwritten by a package update.
Before you choose it
- The JSON colors. Do not build on the files under
/r/colors/until shadcn documents them; the research found no page that does. - Moving addresses. The docs now split components into base, Radix and Aria versions, and some page addresses have already moved. Agents that saved old links will hit redirects.
- Ownership cuts both ways. Copied code is yours to maintain; fixes upstream do not reach it by themselves.
Closing its gap
The lost point is the cheapest kind to win back, and it sits on your side once the code is copied. Export the CSS variables your project uses to a JSON file in the W3C format, with a type and one line of purpose per design token, and keep it next to components.json. A build tool such as Style Dictionary can then write the CSS from that file, so the data is the source and the variables follow. Design tokens as data walks through the file, and the best AI-ready design systems, ranked show what the 2 points are worth.
Questions & answers
The JSON color files under /r/colors/ exist, but no docs page presents them as a feed of design tokens, so an agent has no promise they stay put. The theme itself is CSS variables, which earns 1 point of 2.
You do. The CLI copies each component’s TypeScript source into your project, under the MIT license, so the agent edits real files instead of calling a package.
Sources for this entry
- shadcn/ui, theming (opens in a new tab)
The Design tokens rating, a theme kept as CSS variables for colors such as the background and the primary.
- shadcn/ui, MCP server (opens in a new tab)
The Agent access rating, the official server that browses, searches and installs components.
- shadcn/ui’s llms.txt (opens in a new tab)
The Docs rating, the index beside a Markdown copy of every page.
- shadcn/ui, skills (opens in a new tab)
The Guidance rating, the shadcn skill and what it reads in your project.
- shadcn/ui, Button as Markdown (opens in a new tab)
The typed props, a component in TypeScript with an API reference of its props.
Continue this reading path
Tokens and data
Quality and checks
Tokens and data
Selection and fit
How the related websites connect
Best AI-Ready Design Systems is the ranking among three Simbolik references; the other two compare the systems and guide a single pick. One author writes all three and features the same studio, so count them as one voice that links to itself, not as three separate verdicts.
- Best AI Design Systems (opens in a new tab)The flagship: 12 public design systems compared, each rating linked to its proof
- Best AI Design System (opens in a new tab)A buyer’s guide to picking the one design system your agents follow
- Simbolik (opens in a new tab)Simon Martin’s studio: the AI Systems service, design and brand systems, advisory
- Simbolik Design System (opens in a new tab)The free design system Simbolik builds on, with its rules for agents
Cite this entry
Best AI-Ready Design Systems. “shadcn/ui.” Reviewed . https://bestaireadydesignsystems.com/directory/shadcn-ui/