Skills

Skills (Навыки) предоставляют ИИ-помощникам структурированные знания о Oracul DS — API компонентов, паттерны композиции, конвенции стилизации, правила миграции и распространенные ошибки. После установки ваш ассистент будет знать, как правильно использовать примитивы Oracul DS, не гадая и не совершая ошибок.

Например, вы сможете попросить ассистента:

• "Добавь диалог настроек с формой и кнопками сохранения/отмены."
• "Добавь выбор (select) с группировкой вариантов и фильтром поиска."
• "Перенеси это выпадающее меню из shadcn в Oracul DS."
• "Создай уведомление (toast) для ошибок отправки формы."

Установка

bunnpmpnpmyarn
pnpm dlx skills add https://ds.oracul.co/ui/skills/oracul/SKILL.md
Копировать

Эта команда устанавливает навык Oracul DS в ваш проект. После установки ваш ИИ-ассистент будет автоматически загружать его при работе с компонентами библиотеки.

Узнайте больше об экосистеме навыков на skills.sh.

Что включено

Навык охватывает всю экосистему Oracul DS:

Знания о компонентах

Справочные руководства для всех примитивов — импорты, минимальные паттерны, примеры кода, правила композиции и возможные ошибки. Ассистент будет знать, когда использовать Dialog, когда Sheet, а когда Drawer, как правильно строить оверлеи и формы с помощью Field.

Конвенции стилизации

Использование токенов Tailwind v4, семантическая система цветов, правила размеров иконок, селекторы data-slot, синтаксис --alpha() и работа со шрифтами (--font-sans, --font-mono, --font-heading).

Паттерны миграции

Правила миграции из shadcn/Radix в Oracul DS/Base UI — замена asChild на render, onSelect на onClick, паттерн Select items-first и другие важные изменения API.

CLI и Реестр

Полный справочник по установке компонентов через shadcn CLI, а также пути ручной установки.

Примеры частиц (Particles)

Навык ссылается на каталог частиц — реальные примеры композиции для каждого примитива — поэтому ассистент сможет создавать код, готовый к продакшену, а не просто минимальные заготовки.

Как это работает

1. Активация навыка — Ваш ИИ-агент обнаруживает установленные файлы навыка в проекте.
2. Прогрессивная загрузка — Основной файл SKILL.md содержит базовые правила и индекс реестра. Детальные руководства по компонентам загружаются по запросу, когда это необходимо для выполнения задачи.
3. Соблюдение паттернов — Ассистент следует правилам Oracul DS: использование пропа render для композиции триггеров, структура секций DialogHeader/DialogPanel/DialogFooter, использование variant="ghost" для кнопок отмены и корректные API Base UI.
4. Генерация на основе примеров — Перед созданием кода ассистент обращается к примерам частиц, чтобы соответствовать реальным паттернам библиотеки.

Поддерживаемые агенты

Skills работают с любым агентом, поддерживающим спецификацию Agent Skills, включая Claude Code, Cursor, Codex, Cline, Windsurf, GitHub Copilot и многие другие.