Was ist shadcn/ui?
shadcn/ui ist kein Paket, das du importierst. Die CLI kopiert den Quellcode jeder Komponente in dein Projekt, wo er dir gehört und du ihn bearbeitest, und dieselbe CLI holt Elemente aus Registries von Dritten und privaten Registries. Die Komponenten bauen auf Radix, Base UI oder React Aria auf und werden mit Tailwind gestylt; Einrichtungsanleitungen gibt es für Next.js, Vite, Laravel, React Router, Astro und TanStack Start.
Das Repository enthält außerdem Agent Skills: Ordner mit einer SKILL.md, die ein Coding-Agent lädt, wenn die Aufgabe es verlangt. Der Haupt-Skill, shadcn, liest deine components.json über `shadcn info --json` und gibt dem Agenten dein Framework, die Tailwind-Version, Aliase, Icon-Bibliothek, Basisbibliothek und installierte Komponenten, dazu Regeln, wie sie zusammengesetzt werden. Ein zweiter Skill, migrate-radix-to-base, stellt ein Projekt von Radix auf Base UI um. Installiert werden sie mit Vercels skills-CLI: `npx skills add shadcn/ui`.
Das Repository wurde im Januar 2023 angelegt und hat etwa 128.470 Sterne und 11.417 Forks. Das neueste Release der CLI ist shadcn@4.23.0 (27. Oktober 2026), der jüngste Commit kam am 17. November 2026.
Lohnt sich shadcn/ui?
Der Skill ist wichtiger, als er zunächst wirkt, denn shadcn/ui ist die Bibliothek, zu der Coding-Agenten ohnehin greifen und die sie am häufigsten im Detail falsch verwenden. Ein Agent, der aus seinen Trainingsdaten schreibt, stapelt Formularfelder in einem div mit space-y-4, überschreibt Farben mit bg-blue-500 und vergisst den DialogTitle, den Screenreader brauchen. Der shadcn-Skill ist ein schriftliches Regelwerk gegen genau diese Gewohnheiten: Formulare gehören in FieldGroup und Field, Auswahlen mit 2 bis 7 Optionen nutzen ToggleGroup, Farben kommen aus semantischen Tokens, und jeder Dialog, jedes Sheet und jeder Drawer bekommt einen Titel. Jede Regel verlinkt auf eine Datei mit falschen und richtigen Code-Paaren.
Die zweite Hälfte ist der Projektkontext. Beim Laden führt der Skill `shadcn info --json` aus und gibt dem Agenten deine tatsächliche Konfiguration, auch ob das Projekt Radix, Base UI oder React Aria nutzt, was die API für eigene Trigger ändert. Danach lenkt er den Agenten zu `shadcn search`, `shadcn docs` und `add --diff`, bevor er etwas von Hand schreibt, und weist ihn an, nach der Registry zu fragen, statt zu raten. Der Skill hat eine Evals-Datei mit 8 Testprompts, mehr Disziplin, als die meisten Community-Skills zeigen.
Die Installation ist ein einziger Befehl, `npx skills add shadcn/ui`, ausgeführt im Projekt. Vercels skills-CLI erkennt, welche Agenten du hast (sie nennt Claude Code, Codex, Cursor, OpenCode und 75 weitere), und fragt, wohin die Dateien sollen; mit -g installierst du projektübergreifend. Auf skills.sh zeigt der shadcn-Skill etwa 152.400 Installationen, der Migrations-Skill etwa 38.500. Die Doku beschreibt den Ablauf in Claude Code; das Repo enthält außerdem eine kleine agents/openai.yml, damit der Skill in Codex mit Namen und Icon erscheint. Der separate MCP-Server, eingerichtet mit `npx shadcn@latest mcp init --client claude` (oder cursor, vscode, codex, opencode), lässt den Agenten Registries durchsuchen und daraus installieren; auch dafür liefert der Skill Anleitungen.
Der Sicherheitskompromiss ist konkret. Der Skill genehmigt Shell-Befehle vorab, die `shadcn@latest` über npx, pnpm dlx oder bunx ausführen, also kann der Agent in Claude Code die CLI samt add ohne Nachfrage starten, und @latest heißt: die Version, die npm an diesem Tag ausliefert. Komponenten aus Community-Registries landen als Quellcode in deinem Projekt; der Skill sagt dem Agenten, sie danach zu lesen, und das ist ein Rat, keine Prüfung. Die skills-CLI sendet anonyme Installationstelemetrie, sofern du nicht DISABLE_TELEMETRY=1 setzt.
Als Bibliothek trägt das Modell auch nach fast vier Jahren: Du bekommst lesbaren Code und keinen Lock-in und zahlst dafür mit Pflegeaufwand, weil kopierte Komponenten sich nicht selbst aktualisieren. Die 1.746 offenen Issues und Pull Requests zeigen, wie viel Betrieb auf dem Projekt liegt. Für ein React-Team, das mit Agenten arbeitet, ist der Skill schnell ergänzt und korrigiert die Fehler, die Agenten in diesem Code am häufigsten machen; wer nicht auf shadcn/ui setzt, hat davon nichts.
Wo es sich lohnt
Ein Solo-Gründer, der mit Claude Code ein SaaS-Dashboard in Next.js baut
Eine Einstellungsseite und eine Datentabelle, die einheitlich aussehen, ohne jedes Formular von Hand zu korrigieren
Einmal `npx skills add shadcn/ui` ausführen, dann die Seite anfordern. Der Agent liest die Projektkonfiguration, fügt Tabs, Card und Formularkomponenten über die CLI hinzu und hält sich an die FieldGroup-Regeln. Keine Kosten über die normale Modellnutzung hinaus.
Eine Frontend-Leiterin in einem 20-köpfigen Produktteam mit interner Komponenten-Registry
Agenten sollen unsere Markenkomponenten nutzen, statt neue zu erfinden
Die private Registry mit ihren Auth-Variablen in .env.local in components.json eintragen, Skill und MCP-Server installieren, dann durchsuchen Agenten die Registry, bevor sie Markup schreiben. Die Regel des Skills, nach der Registry zu fragen, hält sie davon ab, standardmäßig öffentliche Elemente zu nehmen.
Ein Team mit einem älteren shadcn/ui-Projekt auf Radix-Basis
Auf Base UI umsteigen, ohne den Build zu brechen
Der Skill migrate-radix-to-base prüft die Basisbibliothek mit `shadcn info`, verlangt einen sauberen Git-Stand, lässt zuerst deinen Typecheck laufen und migriert eine Komponente pro Commit, wobei Radix installiert bleibt, bis die letzte umgezogen ist.
Bevor du dich festlegst
- Einrichtung
- Ein Projekt mit `npx shadcn@latest init` (oder einer Vorlage) anlegen, dann `npx skills add shadcn/ui` im Projektstamm; die skills-CLI braucht Node.js 22.20 oder neuer. Optionaler MCP-Server: `npx shadcn@latest mcp init --client <agent>`; bei Codex muss config.toml von Hand bearbeitet werden.
- Integrationen
- Skills werden über Vercels skills-CLI für Claude Code, Codex, Cursor, OpenCode und weitere Agenten installiert. MCP-Server für Claude Code, Cursor, VS Code mit Copilot, Codex und OpenCode. Registries: die offizielle, Community-Registries und private mit Authentifizierung.
- Daten und Datenschutz
- Eine Frontend-Bibliothek ohne gehosteten Dienst. Der Skill führt die shadcn-CLI lokal aus; die skills-CLI sendet anonyme Installationstelemetrie (DISABLE_TELEMETRY=1 oder DO_NOT_TRACK=1 schaltet sie ab). Tokens für private Registries liegen in deiner .env.local.
- Kosten im großen Maßstab
- In jeder Größe kostenlos. Die echten Kosten sind die Pflege kopierter Komponenten und der Kontext, den der Skill bei jedem Laden hinzufügt; der Tokenverbrauch pro Laden ist nicht veröffentlicht.
- Grenzen
- Nur React, auf Tailwind ausgelegt. Der Skill wird durch eine components.json ausgelöst und tut in Projekten ohne diese Datei nichts. Die Doku zeigt den Ablauf in Claude Code; wie andere Agenten den eingebetteten `shadcn info`-Befehl des Skills behandeln, ist nicht dokumentiert.
Was gut ist
- Der Komponentencode liegt in deinem Repo, ohne Laufzeitabhängigkeit, gegen die du ankämpfen musst
- Der Skill liest die echte Projektkonfiguration, bevor der Agent Code schreibt
- Konkrete Kompositionsregeln mit falschen und richtigen Beispielen
- Ein Installationsbefehl deckt Claude Code, Codex, Cursor und Dutzende weitere Agenten ab
- MIT-Lizenz; Skills, CLI und MCP-Server sind kostenlos
Was nicht
- Der Skill genehmigt nicht festgepinnte `npx shadcn@latest`-Befehle vorab
- Kopierte Komponenten müssen von Hand aktualisiert werden
- Code aus Registries von Dritten prüft nur der Agent, wenn überhaupt
- Nur React und Tailwind
Am besten für
React- und Tailwind-Teams, die Coding-Agenten Oberflächen bauen lassen und wollen, dass das Ergebnis den Konventionen von shadcn/ui folgt.