wix-design-system — скилл для Claude Code: что делает и как установить
Находит компоненты, пропсы, примеры JSX и тест-драйверы библиотеки @wix/design-system прямо в проекте через локальный скрипт или документацию.
MIT 218 установок ★ 40 обновлён 2026-10-24
npx skills add wix/skills --skill wix-design-system -a claude-codeЧто делает wix-design-system
Скилл подключает встроенную утилиту scripts/wds.cjs. Этот скрипт сам находит пакет @wix/design-system в каталоге node_modules монорепозитория или отдельного проекта. Агент вызывает скрипт через Node.js, чтобы искать компоненты по ключевым словам, выводить списки пропсов с типами, извлекать фрагменты JSX и находить иконки из пакета @wix/wix-ui-icons-common.
Для тестов утилита выдаёт сигнатуры методов драйвера и готовые импорты под Unidriver, Playwright или Puppeteer. Если вспомогательный скрипт недоступен, скилл переключается на прямой поиск по файлам Markdown в директории node_modules/@wix/design-system/dist/docs/.
Пакет @wix/design-system обязан быть установлен в зависимостях проекта через npm или yarn, иначе команды завершатся ошибкой. Если интерфейс отображается без стилей, нужно один раз импортировать файл @wix/design-system/styles.global.css в корневой точке входа приложения.
Какие задачи решает
- найти подходящий UI-компонент по ключевым словам
- посмотреть типы пропсов и примеры кода без открытия браузера
- получить методы тест-драйвера для Playwright или Puppeteer
- подобрать иконки из библиотеки @wix/wix-ui-icons-common
- перевести пиксели макета в токены отступов SP
Примеры запросов агенту
- Покажи пропсы и пример использования компонента Button из @wix/design-system
- Найди в WDS компоненты для создания модального окна с формой ввода
- Как импортировать testkit для Card и проверить клик в Playwright?
Как установить wix-design-system
1Через Skills CLI (Vercel)
npx skills add wix/skills --skill wix-design-system -a claude-code2Вручную: положить файлы
~/.claude/skills/wix-design-system/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/wix-design-system/
1Через Skills CLI (Vercel)
npx skills add wix/skills --skill wix-design-system -a codex2Вручную: положить файлы
.agents/skills/wix-design-system/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add wix/skills --skill wix-design-system -a cursor2Вручную: положить файлы
.cursor/skills/wix-design-system/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install wix/skills skills/wix-design-system2Вручную: положить файлы
.github/skills/wix-design-system/SKILL.md1Через Skills CLI (Vercel)
npx skills add wix/skills --skill wix-design-system -a gemini-cli2Командой платформы
gemini skills install https://github.com/wix/skills --path skills/wix-design-systemВручную: положить файлы
.devin/skills/wix-design-system/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add wix/skills --skill wix-design-system -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о wix-design-system
Как установить wix-design-system в Claude Code?
Выполните в терминале команду npx skills add wix/skills --skill wix-design-system -a claude-code. Файл конфигурации сохранится по пути ~/.claude/skills/wix-design-system/SKILL.md.
Что делает wix-design-system?
Он помогает ИИ-агенту ориентироваться в дизайн-системе Wix: искать нужные компоненты, считывать их сигнатуры, получать готовые куски JSX и находить методы для тестирования интерфейса.
Что нужно подготовить перед запуском скилла?
В вашем проекте должна быть установлена библиотека @wix/design-system через npm i @wix/design-system или yarn add @wix/design-system, потому что скрипт считывает документацию прямо из папки node_modules.
Исходный текст
SKILL.md · MIT
---
name: wix-design-system
description: Wix Design System component reference. Use when building UI with @wix/design-system, choosing components, checking props and examples, or writing tests with component testkits. Triggers on "what component", "how do I make", "WDS", "show me props", "testkit", "driver", or component names like Button, Card, Modal, Box, Text.
metadata:
verified: true
---
# WDS Documentation Navigator
**Prerequisite:** `@wix/design-system` must be installed (`npm i @wix/design-system` or `yarn add @wix/design-system`).
## Helper Script
This skill bundles `scripts/wds.cjs` — a Node.js helper that auto-discovers `@wix/design-system` in node_modules (handles monorepos and workspaces) and provides focused lookups. Run it from the user's project directory using the absolute path to the bundled script:
```bash
# WDS is the absolute path to this skill's scripts/wds.cjs
WDS="<this-skill-dir>/scripts/wds.cjs"
node $WDS search <keyword> # Find components by keyword
node $WDS component <Name> # Get props + example list (one component)
node $WDS components <Name1> <Name2>... # Same as `component`, but for several at once
node $WDS example <Name> "<ExampleName>" # Get a specific example
node $WDS testkit <Name> [method] # Get testkit imports + driver API
node $WDS icons <query> # Search for icons
```
## Workflow
### Step 1: Find the right component
```bash
node $WDS search table
node $WDS search form input validation
node $WDS search modal dialog popup
```
Multiple keywords are OR-matched. Returns component names, descriptions, and usage guidance.
### Step 2: Get props and available examples
```bash
node $WDS component Button
```
Returns the full props list (types and descriptions) plus a list of all available examples. For large prop files (>200 lines), returns a summary with prop names and types.
If you already know which several components you'll need (e.g. after Step 1 returned a shortlist), prefer the batch form to avoid one round-trip per component:
```bash
node $WDS components Button Card Table Input Text Thumbnail
```
Output is each component's props block separated by `---`. Missing components are logged to stderr and skipped; the command only fails if every requested component is missing.
### Step 3: Get a specific example
```bash
node $WDS example Button "Loading state"
```
Returns the example description and JSX code. Matching is case-insensitive and supports substrings (e.g., "loading" matches "Loading state").
### Step 4: Write tests with the component testkit
```bash
node $WDS testkit Button # Imports + full driver API for Button
node $WDS testkit Button click # Just the click() method details
```
Returns import snippets for unidriver, vanilla, puppeteer, and playwright flavors plus the driver method API (name, args, return type, description). Method name matching is case-insensitive substring.
### Step 5: Find icons
```bash
node $WDS icons Add Edit Delete
```
Icons are from `@wix/wix-ui-icons-common`. Each icon has a `Small` variant (e.g., `Add` + `AddSmall`).
## Fallback: Direct File Access
If the script is unavailable, docs are at `node_modules/@wix/design-system/dist/docs/`:
- `components.md` — component catalog (~978 lines, grep only)
- `components/{Name}Props.md` — props per component
- `components/{Name}Examples.md` — examples per component (grep `^### ` for section list)
- `components/{Name}Testkit.md` — testkit imports + driver API per component (grep `^### ` for method list)
- `testkits.md` — testkit catalog (list of components with generated testkit docs)
- `icons.md` — icon catalog (~818 lines, grep only)
Don't read these files fully. Grep for keywords, then read specific sections with offset/limit. See [references/file-structure.md](references/file-structure.md) for the exact docs file layout and section shapes.
---
## Quick Component Mapping (Design to WDS)
| Design Element | WDS Component | Notes |
| ------------------- | --------------------------------- | ----------------- |
| Rectangle/container | `<Box>` | Layout wrapper |
| Text button | `<TextButton>` | Secondary actions |
| Input with label | `<FormField>` + `<Input>` | Wrap inputs |
| Toggle | `<ToggleSwitch>` | On/off settings |
| Modal | `<Modal>` + `<CustomModalLayout>` | Use together |
| Grid | `<Layout>` + `<Cell>` | Responsive |
## Spacing (px to SP conversion)
When designer specifies pixels, convert to the nearest SP token:
| Token | Classic | Studio |
| ----- | ------- | ------ |
| `SP1` | 6px | 4px |
| `SP2` | 12px | 8px |
| `SP3` | 18px | 12px |
| `SP4` | 24px | 16px |
| `SP5` | 30px | 20px |
| `SP6` | 36px | 24px |
```tsx
<Box gap="SP2" padding="SP3">
```
Only use SP tokens for `gap`, `padding`, `margin` — not for width/height.
## Imports
```tsx
import { Button, Card, Image } from "@wix/design-system";
import { Add, Edit, Delete } from "@wix/wix-ui-icons-common";
```
## GUIDELINES
1. Don't ever override WDS CSS tokens. Only if it's not possible otherwise, mention that very clearly to the prompter, that this is an anti-pattern and should be avoided at all costs.
### Troubleshooting
- **Components render unstyled** (plain HTML look, missing WDS spacing/typography): add `import "@wix/design-system/styles.global.css";` once to the root/main component (e.g. `page.tsx`, modal entry) — not child/tab/helper files.
© wix · MIT · wix/skills