# server-routes

Скилл server-routes для Claude Code создаёт серверные API-маршруты в TanStack Router и разбирает HTTP-запросы. Эндпоинты размещаются рядом с маршрутами приложения.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 205 установок · ★ 15341 у репозитория
- Автор: TanStack
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/TanStack/router/tree/HEAD/packages/start-client-core/skills/start-core/server-routes/SKILL.md
- Обновлён: 2026-10-25
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/server-routes

## Что делает

Скилл учит агента описывать API-маршруты через `server` в `createFileRoute`. Он работает с обработчиками `GET`, `POST`, `PUT` и `DELETE`, параметрами пути, телом запроса и ответами с JSON, статусами и заголовками. Файлы маршрутов лежат в `src/routes` и следуют соглашениям TanStack Router.

Внутри есть примеры контекста обработчика с `request`, `params`, `context`, `pathname` и `next`. Агент также разбирает middleware для всех обработчиков и отдельного метода через `createHandlers`, а ещё сочетание серверного и UI-маршрута в одном файле. Для работы скиллу нужен `start-core`.

SSR-loader не должен вызывать собственный серверный маршрут через `fetch`: общую операцию следует вынести в серверный сервис и подключить к обеим границам. Это ограничение влияет на структуру приложения.

## Установка

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

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

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add TanStack/router --skill server-routes -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add TanStack/router --skill server-routes -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install TanStack/router packages/start-client-core/skills/start-core/server-routes
```

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

### Gemini CLI

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

2. **Командой платформы**
```bash
gemini skills install https://github.com/TanStack/router --path packages/start-client-core/skills/start-core/server-routes
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add TanStack/router --skill server-routes -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/TanStack/router/tree/HEAD/packages/start-client-core/skills/start-core/server-routes/SKILL.md

## Когда брать
- создать API-маршрут рядом с файлом приложения
- разобрать JSON-тело POST-запроса
- добавить параметры динамического пути
- вернуть JSON с нужным статусом
- подключить middleware только к одному HTTP-методу

## Примеры запросов агенту
- Создай серверный маршрут `src/routes/api/users.ts` с обработчиками `GET` и `POST`.
- Добавь к `POST` в `src/routes/api/posts.ts` проверку через middleware, а к `GET` оставь общий обработчик.
- Покажи, как получить `params.id` и вернуть ответ `404`, если пользователь не найден.

## Похожие
- [vtex-io-http-routes](https://affpapa.org/nevibecode/skills/vtex-io-http-routes.md) — скилл · 1200 установок
- [Cross-Chain Bridge Routes — 60+ Chains via LI.FI](https://affpapa.org/nevibecode/mcp/cross-chain-bridge-routes-60-chains-via-lifi.md) — MCP-сервер · 3748 установок
- [expo-api-routes](https://affpapa.org/nevibecode/skills/expo-api-routes.md) — скилл · 1 установка
- [async-api-routes](https://affpapa.org/nevibecode/rules/async-api-routes.md) — правило · ★ 7191 у репозитория
- [nextjs-dynamic-routes-params](https://affpapa.org/nevibecode/skills/nextjs-dynamic-routes-params.md) — скилл · 304 установки
- [tanstack-start-cursorrules-prompt-file](https://affpapa.org/nevibecode/rules/tanstack-start-cursorrules-prompt-file.md) — правило · ★ 41178 у репозитория

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

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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