# vtex-io-http-routes

Помогает проектировать HTTP-эндпоинты бэкенд-сервиса VTEX IO: границы роутов, middleware, валидацию запросов и форму ответа.

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

## Что делает

Скилл включается, когда сервису VTEX IO нужны явные HTTP-эндпоинты через роуты в `service.json` и обработчики в `node/`. Он разбирает, где проходит граница роута, как собрать цепочку middleware и как описать параметры, query, заголовки и тело запроса прямо у обработчика.

Внутри — правила решений и жёсткие ограничения с примерами кода. Обработчик должен держать контракт явным: если он сразу делегирует вызов, не проверив обязательные параметры, скилл советует остановиться и описать контракт. Повторяющиеся проверки подписи или нормализацию запроса он выносит в middleware, а не копирует по хендлерам. Долгие циклы и пакетные импорты в роуте — повод перенести работу в асинхронный поток и вернуть `202`.

Есть рекомендованная раскладка файлов: `node/routes/` по доменам вроде `orders.ts` и `webhooks.ts`, рядом `node/middlewares/`. Публичный роут считается внешним контрактом, поэтому расширять его до `public` без проверки валидации и авторизации не стоит. Скилл не для GraphQL, не для политик в `manifest.json` и не для настройки рантайма — на этих задачах он не поможет.

## Установка

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

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

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add vtex/skills --skill vtex-io-http-routes -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add vtex/skills --skill vtex-io-http-routes -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install vtex/skills vtex-io-http-routes
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add vtex/skills --skill vtex-io-http-routes -a opencode
```

### Claude.ai

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

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

## Когда брать
- описать контракт вебхука для партнёра
- вынести проверку подписи в middleware
- разделить синхронный роут и фоновую обработку
- свести статусы и форму ответа к одному виду
- разложить роуты по файлам доменов

## Примеры запросов агенту
- добавь вебхук для колбэка партнёра в service.json и обработчик в node/routes
- проверь, что обработчик заказа валидирует параметры до вызова клиента
- вынеси проверку x-signature в middleware и подключи к роутам заказов

## Похожие
- [convex-http-actions](https://affpapa.org/nevibecode/skills/convex-http-actions.md) — скилл · 2700 установок
- [extension-http-outcalls](https://affpapa.org/nevibecode/skills/extension-http-outcalls.md) — скилл · 28100 установок
- [flutter-use-http-package](https://affpapa.org/nevibecode/skills/flutter-use-http-package.md) — скилл · 36100 установок
- [http-parameter-pollution](https://affpapa.org/nevibecode/skills/http-parameter-pollution.md) — скилл · 3600 установок
- [http-host-header-attacks](https://affpapa.org/nevibecode/skills/http-host-header-attacks.md) — скилл · 3600 установок
- [nodejs-express-server](https://affpapa.org/nevibecode/skills/nodejs-express-server.md) — скилл · 3300 установок

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

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