К основному содержанию
скилл CX Codex

ui-sdk — скилл для Claude Code: интерфейсы и установка

Скилл для Claude Code помогает собирать интерфейсы на ui-sdk и проверять их поведение. Подключается к задачам с установленным пакетом @ui-sdk/* или по запросу про ui-sdk.

Apache-2.0 4 700 установок ★ 6 464 обновлён 2026-11-16

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add vercel-labs/ui --skill ui-sdk -a claude-code
Открыть на GitHub

Что делает ui-sdk

Скилл помогает собирать интерфейсы из компонентов ui-sdk и создавать недостающие компоненты на основе @ui-sdk/core. Он охватывает React, Vue, Svelte, Solid и веб-компоненты, а также настройку доступности интерфейса для агентов через createAgent, инструменты агентов и WebMCP.

Для задачи он выбирает нужные страницы документации и типы из установленного пакета. Локальная документация соответствует версии библиотеки в проекте. Скилл также задаёт правила импорта и стилей, а в конце предлагает проверять типы и запускать тесты, включая проверки клавиатуры, фокуса, ARIA, серверного рендеринга и направления справа налево.

Какие задачи решает

  • собрать интерфейс из компонентов ui-sdk
  • создать отсутствующий компонент на основе @ui-sdk/core
  • подготовить интерфейс для работы с агентами
  • проверить клавиатурную навигацию, фокус и ARIA
  • написать тесты для существующего компонента

Примеры запросов агенту

  • Собери страницу настроек из компонентов ui-sdk в React.
  • Создай компонент пошаговой формы на основе @ui-sdk/core.
  • Добавь тесты для клавиатурной навигации и доступности существующего компонента.

Как установить ui-sdk

1Через Skills CLI (Vercel)

npx skills add vercel-labs/ui --skill ui-sdk -a claude-code

2Вручную: положить файлы

~/.claude/skills/ui-sdk/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/ui-sdk/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об ui-sdk

Как установить ui-sdk в Claude Code?

Выполни npx skills add vercel-labs/ui --skill ui-sdk -a claude-code. Файл скилла находится в ~/.claude/skills/ui-sdk/SKILL.md.

Что делает ui-sdk?

Скилл помогает собирать интерфейсы из компонентов ui-sdk, создавать недостающие компоненты и проверять доступность, поведение и тесты.

Что нужно для работы ui-sdk?

В проекте должен быть установлен пакет @ui-sdk/*. Если пакетов ui-sdk ещё нет, скилл предписывает установить @ui-sdk/core и пакет для нужного фреймворка через менеджер пакетов проекта.

Исходный текст

SKILL.md · Apache-2.0
---
name: ui-sdk
description: Builds interfaces with ui-sdk in React, Vue, Svelte, Solid or web components. Covers choosing and composing its components, building a component or behavior it doesn't ship from @ui-sdk/core (like a stepper, splitter, transfer list or emoji picker), making the interface usable by agents through createAgent, agent tools and WebMCP, and testing keyboard, focus, ARIA, server rendering and right to left, including writing tests for an existing component. Use whenever a project has @ui-sdk/* installed or the user mentions ui-sdk.
---

# Build with ui-sdk

ui-sdk is a library of UI behaviors: keyboard navigation, focus, selection, dismissal, popups, drag and drop and the ARIA they need. Its components are built from those behaviors and render no styles of their own, in React, Vue, Svelte, Solid and web components. `@ui-sdk/core/web.css` gives them an optional default look. When a component is missing, you build it from the same behaviors in `@ui-sdk/core`, and it gets the same keyboard, focus, server rendering and right to left support.

## Read first

The docs for the installed version ship in each package, as Markdown:

- `node_modules/@ui-sdk/<framework>/docs/llms.txt` is the index. Read it first. `<framework>` is `react`, `vue`, `svelte`, `solid` or `web`.
- Then read only the pages your task needs, like `docs/components/select.md`. Don't read the whole `docs/` folder; it's large.
- An interface built from our components doesn't need `docs/core.md`. Only path 2 below does, and even then you search it by heading: it's over 300 KB. `docs/rendering.md` sits next to it in the same `docs/` folder.
- Don't read compiled JavaScript in `dist/*.js`, even to debug. The docs and the `.d.ts` types are the API; when they don't answer, write a small test that tries it.

The same docs are online at https://ui-sdk.dev/docs. Prefer the installed copy: it matches the version in the project.

A page with no build step, like an Artifact, installs nothing: it loads `https://ui-sdk.dev/web.js` and `web.css` with two tags. Read https://ui-sdk.dev/web.md instead of `llms.txt`. It's the web components docs in one file, for that page, and [references/web-components.md](references/web-components.md#without-a-bundler) has the rest.

Otherwise, if no `@ui-sdk` package is installed yet, install `@ui-sdk/core` and the framework's package with the project's package manager. In a Nuxt 4 or newer app using `@ui-sdk/vue`, also add `"@ui-sdk/vue"` to `modules` in `nuxt.config.ts`.

## Pick your path

1. **Build an interface from our components**, like a settings page, a form or a command palette: read [references/build-interface.md](references/build-interface.md).
2. **Build a component or behavior ui-sdk doesn't ship**, or extend one of ours: read [references/create-component.md](references/create-component.md).

Most interfaces only need path 1. When one part of it needs a component we don't have, follow path 2 for that part.

Every path ends the same way:

3. **Make it agent-ready**: [references/agent-ready.md](references/agent-ready.md).
4. **Test it**: [references/testing.md](references/testing.md).

## Rules for every path

- **Import from entries.** Each component has its own entry, like `@ui-sdk/react/select`. Import components from there, not from a package root. Never import `@ui-sdk/core/internal/*`.
- **One shape everywhere.** A root and its parts, nested as the component page's Composition shows. Change a part's element with `render`, never an `as` prop.
- **Default or controlled.** `defaultValue` to start, or `value` with `onValueChange(value, details)` to control it (each framework's idiom: `v-model` in Vue, `bind:value` in Svelte, properties and events in web components). `details` has `reason`, `source` and `cancel()`.
- **Name every control.** Use the component's label part (`FieldLabel`, `SelectLabel`, `DialogTitle`), or `aria-label` when there's no visible text. People using screen readers and agents both find controls by name.
- **Style from state.** Target `data-slot` and state attributes like `data-open` or `data-pressed`, and the CSS variables each component lists. Never inline styles for state, and never generated ids. When the app uses `web.css`, read [references/styles.md](references/styles.md) first: it draws icons and sets sizes you can't see in the markup.
- **Declare the ui-sdk layer.** Put `@layer ui-sdk;` at the top of the global stylesheet, above `@import "tailwindcss"` if there is one.
- **Check color.** Text needs 4.5:1 against what's behind it, and control edges, focus rings and state fills 3:1. jsdom can't see color, so check it in a real browser.
- **Key lists by value or id**, never by index.
- **Right to left needs no provider.** Components read the direction from the page.
- **Comments are rare.** Write one only when a reader would get the code wrong without it, like a browser quirk or a trade-off, in one or two lines. Never comment what the code does, what a value is, or which section starts here, and no JSDoc blocks on app code.
- **Don't hand-roll what we ship.** Before you write any `role=` attribute, look for the component in the table in [references/build-interface.md](references/build-interface.md). A `div` with `role="listbox"`, `"menu"`, `"dialog"`, `"tablist"`, `"separator"`, `"switch"`, `"slider"`, `"radiogroup"`, `"toolbar"` or `"tree"` next to an installed ui-sdk package is almost always a bug.

## When you're done

1. **Typecheck.** If the root `tsconfig.json` has `"files": []` and `references`, `npx tsc --noEmit` checks nothing: run `npx tsc -b` or `npx tsc --noEmit -p <app config>`. For Svelte, run `svelte-check`; for Vue, `vue-tsc`.
2. **Write and run tests** (see testing.md). Every task gets tests, and every interface gets at least the agent test from agent-ready.md. If a test finds a bug in code you were asked only to test, mark it `test.fails` (or `it.fails`) with a one-line reason, report the bug, and leave the suite green.
3. **Read every comment in your diff.** Delete it unless it names a browser quirk, an APG rule or a trade-off, and cut what's left to two lines. Turn JSDoc on app code into a plain comment or delete it. Never tell the reader to replace something.
4. **Report** each command you ran with its exit code, anything you couldn't check, and anything the docs or types got wrong or left out.

© vercel-labs · Apache-2.0 · vercel-labs/ui

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
ai-sdk vercel Скилл помогает писать код на базе Vercel AI SDK и не допускать устаревших API. Он проверяет локальную документацию пакета перед генерацией. CX Codex +1 70 700установок sentry-android-sdk getsentry Скилл sentry-android-sdk сканирует проект на Android и пошагово настраивает отслеживание ошибок, трейсинг и сессии в Sentry. Пригодится при подключении мониторинга в кодовую базу на Kotlin или Java. CX Codex +1 2 500установок probe-sdk официальный anthropics Скилл probe-sdk для Claude Code помогает подключить Zoom Probe SDK к проверке устройств, браузера и сети перед встречей. Агент выбирает его после перехода к предварительной диагностике. CX Codex +1 2 200установок ima-sdk-client-side официальный Google LLC Скилл ima-sdk-client-side для Claude Code помогает подключать Google IMA SDK для клиентской вставки видео- и аудиорекламы по VAST или VMAP. Описывает интеграцию для сайтов, приложений и ТВ-платформ. CX Codex +1 4 500установок ima-dai-sdk официальный Google LLC Подключает Google IMA DAI SDK для загрузки HLS- и DASH-потоков. Работает с прямыми эфирами и видео по запросу в приложениях и на сайтах. CX Codex +1 4 300установок sentry-nextjs-sdk getsentry Скилл sentry-nextjs-sdk для Claude Code настраивает Sentry в приложениях Next.js. Он подключается по просьбе добавить Sentry или настроить мониторинг ошибок, трассировку и другие функции наблюдаемости. CX Codex +1 3 800установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой