# shadcn-ui

Учит агента работать с shadcn/ui: добавлять компоненты через CLI, настраивать темы на oklch и собирать формы с проверкой через Zod.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 176 установок · ★ 29 у репозитория
- Автор: oakoss
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/oakoss/agent-skills/tree/HEAD/skills/shadcn-ui/SKILL.md
- Обновлён: 2026-08-17
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/oakoss-shadcn-ui

## Что делает

Скилл объясняет агенту, как устроен shadcn/ui: компоненты не ставятся зависимостью из npm, а копируются в проект через CLI (`npx shadcn@latest add`) и дальше правятся как свой код. Внутри есть таблица частых команд и типовых промахов, а рядом четыре справочника — темы и тёмный режим, варианты компонентов, формы, CLI и реестры.

Темы строятся на CSS-переменных в `:root` с цветами в формате oklch и маппингом через `@theme inline`; тёмный режим переключает значения под классом `.dark`. Формы собираются на компоненте `<Field />` вместе с React Hook Form или TanStack Form и схемой Zod. Старый `<Form />` пока работает, но его больше не развивают.

Скилл рассчитан на React 19 и Tailwind CSS 4, поэтому в проекте без Tailwind или на другом фреймворке он мимо: для Vue и Svelte есть отдельные порты. Из полезного — напоминание, что `forwardRef` в React 19 устарел и `ref` передаётся обычным пропом.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add oakoss/agent-skills --skill shadcn-ui -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/shadcn-ui/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/shadcn-ui/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add oakoss/agent-skills --skill shadcn-ui -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/shadcn-ui/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add oakoss/agent-skills --skill shadcn-ui -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/shadcn-ui/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install oakoss/agent-skills skills/shadcn-ui
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/shadcn-ui/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add oakoss/agent-skills --skill shadcn-ui -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/oakoss/agent-skills --path skills/shadcn-ui
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/shadcn-ui/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add oakoss/agent-skills --skill shadcn-ui -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/oakoss/agent-skills/tree/HEAD/skills/shadcn-ui/SKILL.md

## Когда брать
- добавить компонент shadcn/ui в проект и не тянуть его как npm-зависимость
- перевести палитру на oklch и настроить тёмный режим через `.dark`
- собрать форму с валидацией на Zod
- сделать свои варианты кнопки через `cva()`
- описать собственный реестр компонентов и собрать из него JSON

## Примеры запросов агенту
- Добавь компонент `dialog` через shadcn CLI и покажи, куда скопировались файлы
- Переведи наши цветовые токены на oklch и настрой тёмную тему через класс `.dark`
- Собери форму логина на `<Field />`, React Hook Form и схеме Zod

## Похожие
- [shadcn](https://affpapa.org/nevibecode/skills/pymodel-shadcn.md) — скилл · 599 установок
- [tanstack-start-shadcn-tailwind](https://affpapa.org/nevibecode/rules/tanstack-start-shadcn-tailwind.md) — правило · ★ 41430 у репозитория
- [shadcn-component-review](https://affpapa.org/nevibecode/skills/shadcn-component-review.md) — скилл · 676 установок
- [shadcn-layouts](https://affpapa.org/nevibecode/skills/shadcn-layouts.md) — скилл · 463 установки
- [json-render-shadcn](https://affpapa.org/nevibecode/skills/json-render-shadcn.md) — скилл · 257 установок
- [shadcn-code-review](https://affpapa.org/nevibecode/skills/shadcn-code-review.md) — скилл · 206 установок

## Другие версии с тем же именем
- [shadcn-ui · google-labs-code](https://affpapa.org/nevibecode/skills/shadcn-ui.md) — 55400 установок
- [shadcn-ui · nexu-io](https://affpapa.org/nevibecode/skills/nexu-io-shadcn-ui.md) — 3100 установок
- [shadcn-ui · giuseppe-trisciuoglio](https://affpapa.org/nevibecode/skills/giuseppe-trisciuoglio-shadcn-ui.md) — 22800 установок
- [shadcn-ui · jezweb](https://affpapa.org/nevibecode/skills/jezweb-shadcn-ui.md) — 3600 установок
- [shadcn-ui · existential-birds](https://affpapa.org/nevibecode/skills/existential-birds-shadcn-ui.md) — 358 установок

Из того же набора: [oakoss/agent-skills](https://affpapa.org/nevibecode/by/oakoss/agent-skills.md) — 106 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
