# graphql-api-development

Скилл для проектирования GraphQL API на graphql-js: схема, резолверы, запросы, мутации, подписки и авторизация. Пригодится, когда REST уже тесен.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 447 установок · ★ 62
- Автор: manutej
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/manutej/luxor-claude-marketplace/tree/HEAD/plugins/luxor-backend-toolkit/skills/graphql-api-development/SKILL.md
- Обновлён: 2026-06-13
- HTML: https://affpapa.org/nevibecode/skills/graphql-api-development

## Что делает

Скилл ведёт агента по проектированию GraphQL API на graphql-js: типы и схема, резолверы, запросы, мутации, подписки, обработка ошибок, аутентификация и авторизация, кэширование. Внутри разобраны два способа описания схемы — SDL и программный API — и паттерны: input-типы для мутаций, интерфейсы для общих полей, union для полиморфных ответов, пагинация по offset и по курсору в стиле Relay.

Отдельный раздел объясняет, когда GraphQL выигрывает у REST, а когда лучше остаться на REST: простой CRUD, загрузка файлов, критичное HTTP-кэширование. Это повод проверить, нужен ли вам вообще переход, а не тащить GraphQL ради моды.

Скилл рассчитан на серверы на Node.js с Express. Текст обрезан на разделе о версионировании, поэтому про миграцию схемы и деплой он ничего не обещает. Схема и примеры кода даны на JavaScript и TypeScript.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add manutej/luxor-claude-marketplace --skill graphql-api-development -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add manutej/luxor-claude-marketplace --skill graphql-api-development -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add manutej/luxor-claude-marketplace --skill graphql-api-development -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install manutej/luxor-claude-marketplace graphql-api-development
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add manutej/luxor-claude-marketplace --skill graphql-api-development -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/manutej/luxor-claude-marketplace --path plugins/luxor-backend-toolkit/skills/graphql-api-development
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add manutej/luxor-claude-marketplace --skill graphql-api-development -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/manutej/luxor-claude-marketplace/tree/HEAD/plugins/luxor-backend-toolkit/skills/graphql-api-development/SKILL.md

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

## Примеры запросов агенту
- Спроектируй схему GraphQL для блога: пользователи, посты, комментарии
- Напиши резолверы для вложенных полей Post.author и User.posts
- Добавь мутацию createPost с input-типом и union-ошибками

## Похожие
- [graphql-operations](https://affpapa.org/nevibecode/skills/graphql-operations.md) — скилл · 3600 установок
- [graphql-development](https://affpapa.org/nevibecode/skills/graphql-development.md) — скилл · 661 установка
- [implement-graphql-api](https://affpapa.org/nevibecode/commands/implement-graphql-api.md) — команда · 212 установок
- [graphql-architect](https://affpapa.org/nevibecode/agents/graphql-architect.md) — субагент · 1038 установок
- [graphql-implementation](https://affpapa.org/nevibecode/skills/graphql-implementation.md) — скилл · 380 установок
- [apollo-graphql](https://affpapa.org/nevibecode/rules/apollo-graphql.md) — правило · ★ 3579

Из того же набора: [manutej/luxor-claude-marketplace](https://affpapa.org/nevibecode/by/manutej/luxor-claude-marketplace.md) — 31 карточка

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