# sales-app-extensibility

Помогает разрабатывать, настраивать и собирать расширения для VTEX Sales App. Проводит через семь этапов от проверки структуры проекта до деплоя.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 856 установок · ★ 46
- Автор: vtex
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/vtex/skills/tree/HEAD/skills/sales-app-extensibility/SKILL.md
- Обновлён: 2026-10-14
- HTML: https://affpapa.org/nevibecode/skills/sales-app-extensibility

## Что делает

Скилл координирует создание интерфейсных расширений для корзины, меню и карточки товара в VTEX Sales App. Процесс строго разбит на семь шагов. Сначала агент проверяет окружение, затем собирает требования, планирует архитектуру, генерирует код компонентов и документацию. Стили компонентов пишутся только в обычном CSS. Модули `.module.css` платформа не поддерживает.

Внутри учитываются жёсткие ограничения среды. Все регистрируемые компоненты обязаны возвращать `JSX.Element`. Если вернуть `null`, компилятор TypeScript выдаст ошибку. При отсутствии данных код должен отдавать пустой фрагмент `<></>`. Скилл также следит за хуками `useCart`, `useCartItem` и `usePDP`, требуя проверять опциональные поля перед чтением.

Без настроенного проекта FastStore и рабочего пакета `@vtex/sales-app` генерация кода сразу остановится.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add vtex/skills --skill sales-app-extensibility -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add vtex/skills --skill sales-app-extensibility -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add vtex/skills --skill sales-app-extensibility -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install vtex/skills sales-app-extensibility
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add vtex/skills --skill sales-app-extensibility -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/vtex/skills --path skills/sales-app-extensibility
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add vtex/skills --skill sales-app-extensibility -a opencode
```

### Claude.ai

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

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

## Когда брать
- встроить блок рекомендаций или гарантий в карточку товара
- добавить сервисы и акции на страницу корзины
- сгенерировать типизированный компонент под точки расширения VTEX Sales App
- настроить безопасный вызов API через прокси VTEX IO

## Примеры запросов агенту
- Создай расширение для корзины в точке cart.cart-item.after с показом скидок
- Добавь блок с гарантией на страницу товара через точку pdp.sidebar.after
- Подключи внешний API через прокси VTEX IO для расширения меню menu.drawer-content

## Похожие
- [power-apps-code-app-scaffold](https://affpapa.org/nevibecode/skills/power-apps-code-app-scaffold.md) — скилл · 8700 установок
- [nextjs-app-router](https://affpapa.org/nevibecode/skills/nextjs-app-router.md) — скилл · 3900 установок
- [contentful-custom-app-from-scratch](https://affpapa.org/nevibecode/skills/contentful-custom-app-from-scratch.md) — скилл · 2800 установок
- [create-mcp-app](https://affpapa.org/nevibecode/skills/create-mcp-app.md) — скилл · 2700 установок
- [nextjs-app-router-fundamentals](https://affpapa.org/nevibecode/skills/nextjs-app-router-fundamentals.md) — скилл · 2200 установок
- [migrate-oai-app](https://affpapa.org/nevibecode/skills/migrate-oai-app.md) — скилл · 1100 установок

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

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