К основному содержанию
скилл CX Codex

graphql-expert · travisjneuman — скилл для Claude Code: что делает и как установить

Скилл graphql-expert для Claude Code помогает проектировать схемы GraphQL, писать резолверы и оптимизировать запросы. Включается при создании API или настройке DataLoader.

MIT 132 установок ★ 114 обновлён 2026-11-10

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add travisjneuman/.claude --skill graphql-expert -a claude-code
Открыть на GitHub

Что делает graphql-expert

Скилл задаёт правила проектирования GraphQL API: структуру скаляров и интерфейсов, правила nullability, мутации через input-типы и оформление корневых типов Query, Mutation и Subscription. Агент обращается к нему при создании схем, реализации резолверов или оптимизации производительности.

Внутрь вынесены справочные файлы по пагинации, пакетным мутациям, контексту резолверов, авторизации и форматированию ошибок. Для устранения проблемы N+1 используется DataLoader. Защита API строится на ограничении глубины и расчёте сложности запросов.

Готовые схемы проверяются по встроенному чек-листу. Он требует PascalCase для типов, выделенные типы полезной нагрузки и обязательную пагинацию списков.

Какие задачи решает

  • спроектировать схему GraphQL с корректными типами и nullability
  • устранить проблему N+1 в резолверах с помощью DataLoader
  • настроить авторизацию на уровне контекста или директив
  • ограничить глубину и сложность входящих GraphQL-запросов

Примеры запросов агенту

  • Спроектируй схему GraphQL для системы комментариев с пагинацией
  • Напиши резолвер с DataLoader, чтобы убрать N+1 при загрузке постов
  • Проверь схему по чек-листу graphql-expert и добавь типы ошибок

Как установить graphql-expert

1Через Skills CLI (Vercel)

npx skills add travisjneuman/.claude --skill graphql-expert -a claude-code

2Вручную: положить файлы

~/.claude/skills/graphql-expert/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/graphql-expert/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о graphql-expert

Как установить graphql-expert в Claude Code?

Выполните команду npx skills add travisjneuman/.claude --skill graphql-expert -a claude-code.

Что делает graphql-expert?

Скилл передаёт агенту правила построения схем, реализации резолверов и оптимизации запросов GraphQL.

Какие методы оптимизации производительности входят в скилл?

Справочные материалы описывают применение DataLoader против проблемы N+1, сохраняемые запросы (persisted queries), а также лимиты сложности и глубины выборки.

Исходный текст

SKILL.md · MIT
---
name: graphql-expert
description: GraphQL API design and implementation. Use when building GraphQL APIs, designing schemas, implementing resolvers, or optimizing GraphQL performance.
---

# GraphQL Expert

Comprehensive guide for designing and implementing GraphQL APIs.

## GraphQL Fundamentals

### What is GraphQL?

```
GraphQL is a query language for APIs that:
✓ Lets clients request exactly what they need
✓ Gets multiple resources in one request
✓ Uses a type system to describe data
✓ Provides introspection (self-documenting)

GraphQL vs REST:
┌─────────────────────────────────────────┐
│ REST: Multiple endpoints, fixed shapes  │
│ GET /users/1                            │
│ GET /users/1/posts                      │
│ GET /users/1/followers                  │
├─────────────────────────────────────────┤
│ GraphQL: Single endpoint, flexible      │
│ POST /graphql                           │
│ query { user(id: 1) {                   │
│   name                                  │
│   posts { title }                       │
│   followers { name }                    │
│ }}                                      │
└─────────────────────────────────────────┘
```

---

## Schema Design

### Type System

```graphql
# Scalar Types (built-in)
String, Int, Float, Boolean, ID

# Custom Scalar
scalar DateTime
scalar JSON

# Object Type
type User {
  id: ID!
  email: String!
  name: String
  createdAt: DateTime!
  posts: [Post!]!
}

# Enum
enum Role {
  ADMIN
  USER
  GUEST
}

# Interface
interface Node {
  id: ID!
}

type User implements Node {
  id: ID!
  # ... other fields
}

# Union
union SearchResult = User | Post | Comment

# Input Type (for mutations)
input CreateUserInput {
  email: String!
  name: String!
  role: Role = USER
}
```

### Nullability

```graphql
# Field modifiers:
String      # Nullable string
String!     # Non-null string
[String]    # Nullable list of nullable strings
[String!]   # Nullable list of non-null strings
[String]!   # Non-null list of nullable strings
[String!]!  # Non-null list of non-null strings

# Best practice:
# - Make fields nullable by default
# - Use ! only when guaranteed non-null
# - Lists should usually be non-null: [Item!]!
```

### Schema Structure

```graphql
# Root Types
type Query {
  # Read operations
  user(id: ID!): User
  users(limit: Int, offset: Int): [User!]!
  me: User
}

type Mutation {
  # Write operations
  createUser(input: CreateUserInput!): User!
  updateUser(id: ID!, input: UpdateUserInput!): User!
  deleteUser(id: ID!): Boolean!
}

type Subscription {
  # Real-time updates
  userCreated: User!
  messageReceived(roomId: ID!): Message!
}
```

---

## Reference files

Detailed material is in separate files so this overview stays short. Read only the file whose topic matches the task; each one is self-contained. Paths are relative to the folder that holds this `SKILL.md` (in the full toolkit install, `~/.claude/skills/graphql-expert/`).

| Topic | File | Covers |
| --- | --- | --- |
| Query Design | [`references/query-design.md`](references/query-design.md) | Basic Queries; Pagination; Filtering & Sorting |
| Mutations | [`references/mutations.md`](references/mutations.md) | Mutation Design; Batch Mutations |
| Resolvers | [`references/resolvers.md`](references/resolvers.md) | Basic Resolvers; Resolver Context |
| Performance Optimization | [`references/performance-optimization.md`](references/performance-optimization.md) | DataLoader (N+1 Solution); Query Complexity; Query Depth Limiting; Persisted Queries |
| Authentication & Authorization | [`references/authentication-and-authorization.md`](references/authentication-and-authorization.md) | Context-Based Auth; Directive-Based Auth |
| Error Handling | [`references/error-handling.md`](references/error-handling.md) | Error Types; Error Formatting |
| Subscriptions | [`references/subscriptions.md`](references/subscriptions.md) | Setup; With Filtering |
| Client Integration | [`references/client-integration.md`](references/client-integration.md) | Apollo Client Setup; React Hooks |
| Best Practices | [`references/best-practices.md`](references/best-practices.md) | DO:; DON'T: |

## Schema Checklist

- [ ] Types named descriptively (singular, PascalCase)
- [ ] Consistent nullability patterns
- [ ] Input types for all mutations
- [ ] Payload types with error handling
- [ ] Pagination for all lists
- [ ] Authentication/authorization considered
- [ ] Performance optimizations in place

© travisjneuman · MIT · travisjneuman/.claude

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →

Сначала — graphql-expert от других авторов.

graphql-expert martinholovsky Скилл graphql-expert для Claude Code помогает проектировать GraphQL-схемы, писать резолверы и настраивать федерацию. Он включается при разработке API, работе с Apollo Server и оптимизации запросов. CX Codex +1 220установок graphql-expert personamanagmentlayer Скилл graphql-expert помогает проектировать GraphQL-схемы, писать резолверы и разбирать подписки. Пригодится при работе с Apollo Server, федерацией и проблемой N+1. CX Codex +1 169установок graphql-schema-designer patricio0312rev Скилл graphql-schema-designer для Claude Code помогает спроектировать GraphQL API с типами, запросами, мутациями, подписками и резолверами. Включается по запросам о схеме, настройке GraphQL или Apollo Server. CX Codex +1 230установок graphql-implementation secondsky Скилл graphql-implementation для Claude Code проектирует схемы GraphQL, пишет резолверы, настраивает DataLoader и обработку ошибок. Применяется при создании API, переходе с REST и настройке подписок. CX Codex +1 400установок graphql davila7 Помогает Claude Code проектировать GraphQL-схемы, защищать сервер от глубоких запросов и настраивать DataLoader против проблемы N+1. CX Codex +1 124установок rest-to-graphql-migrator patricio0312rev Скилл rest-to-graphql-migrator проводит пошаговую миграцию REST API на GraphQL: описывает эндпоинты, строит схему, оборачивает существующие ручки в data source и переносит их по одной. CX Codex +1 277установок graphql-performance-optimizer davila7 Субагент graphql-performance-optimizer для Claude Code анализирует узкие места GraphQL API и предлагает изменения для запросов, резолверов и кэширования. Запускается при проблемах с N+1, пагинацией или задержками федерации. CX Codex 599установок graphql-development Mindrally Скилл graphql-development для Claude Code задаёт агенту правила для GraphQL: схема, типизированные клиенты, интеграция с React и Next.js. Направляет написание резолверов и запросов. CX Codex +1 701установок

Из того же набора117

Весь набор →
battle-card-builder Скилл battle-card-builder генерирует батл-карты и сценарии отработки возражений для отдела продаж по чёткой восьмичастной структуре. CX Codex +1 137установок serverless-development Скилл serverless-development для Claude Code разбирает бессерверные функции AWS Lambda, Vercel Edge и Cloudflare Workers. API и вебхуки масштабируются сами. CX Codex +1 133установок growth-engineering Скилл growth-engineering для Claude Code содержит шаблоны A/B-тестирования, фича-флагов, воронок активации и виральных циклов. CX Codex +1 133установок email-systems Скилл email-systems для Claude Code и Codex помогает настроить отправку транзакционных писем, вёрстку шаблонов и DNS-записи. Включается при создании почтовой инфраструктуры или отладке спам-фильтров. CX Codex +1 132установок ar-vr-xr Скилл ar-vr-xr для Claude Code помогает проектировать AR-, VR- и XR-приложения для Unity, WebXR и устройств Apple и Meta. Помогает продумывать взаимодействия, интерфейс и производительность в пространстве. CX Codex +1 125установок blockchain-web3 Скилл blockchain-web3 для Claude Code помогает писать Solidity-контракты, собирать dApp и проверять типовые уязвимости Web3. Охватывает EVM, DeFi, NFT и интеграцию кошельков. CX Codex +1 109установок data-engineering Скилл data-engineering для Claude Code помогает проектировать конвейеры данных и схемы хранилищ. Включается при настройке ETL/ELT, потоковой обработки и преобразований dbt. CX Codex +1 105установок compliance-engineering Скилл compliance-engineering для Claude Code описывает реализацию требований SOC 2, HIPAA, GDPR, PCI-DSS и FedRAMP в коде. Помогает добавлять контроль доступа, шифрование и аудит при подготовке проекта к проверке. CX Codex +1 102установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой