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

graphql-expert-best-practices — скилл GraphQL для Claude Code

Скилл graphql-expert-best-practices для Claude Code задаёт правила для схем, резолверов, мутаций и пагинации GraphQL. Агент обращается к ним при написании и ревью схем.

MIT 144 установок ★ 9 обновлён 2026-02-11

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

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

Скилл даёт агенту набор правил для GraphQL API: резолверы, схема, мутации, пагинация. Правила разбиты по приоритету, от критичных к средним, и помечены префиксами dataloader-, schema-, mutation-, pagination-, security- и operations-. Внутри — батчинг через DataLoader против N+1, запрет произвольных JSON-фильтров и бинарных полей в схеме, один input-объект на мутацию, лимиты сложности запроса, выключенная интроспекция в проде.

Каждое правило лежит отдельным файлом в rules/: короткое объяснение, когда приём уместен и когда нет, пример плохого кода и рядом исправленный. Агент открывает нужные файлы по ходу работы, поэтому скилл включается в момент написания или ревью схемы и резолверов, а не отдельной проверкой после.

Сам он ничего не запускает. Правила категоричные: скажем, произвольные JSON-фильтры в схеме запрещены целиком из-за риска NoSQL-инъекций, так что на проекте, где такой фильтр уже живёт в проде, скилл будет требовать переделки.

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

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

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

  • Проверь резолверы user.posts: почему на каждый пост уходит отдельный запрос и как переписать это через DataLoader?
  • Отревьюй схему в schema.graphql по своим правилам и скажи, какие поля переделывать первыми.
  • Спроектируй мутацию createOrder с одним input-объектом и union-результатом вместо исключений.

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

1Через Skills CLI (Vercel)

npx skills add wispbit-ai/skills --skill graphql-expert-best-practices -a claude-code

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

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

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

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

Вопросы о graphql-expert-best-practices

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

Выполните npx skills add wispbit-ai/skills --skill graphql-expert-best-practices -a claude-code. Файл скилла появится по пути ~/.claude/skills/graphql-expert-best-practices/SKILL.md.

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

Даёт агенту правила для схем, резолверов, мутаций и пагинации GraphQL. С ними код пишется и ревьюится с оглядкой на N+1, безопасность схемы и лишние поля в ответе.

Какие правила идут первыми?

Верхний приоритет у dataloader- про батчинг и N+1, следом schema- и mutation-. Пагинация, безопасность и операции стоят ниже.

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

SKILL.md · MIT
---
name: graphql-expert-best-practices
description: GraphQL performance optimization and best practices for building scalable APIs. This skill should be used when writing, reviewing, or refactoring GraphQL schemas, resolvers, or query execution code. Triggers on tasks involving GraphQL APIs, resolver optimization, query performance, or data fetching patterns.
license: MIT
metadata:
  author: wispbit
  version: "1.0.0"
---

# GraphQL Expert Best Practices

Comprehensive performance optimization and best practices guide for GraphQL APIs. Contains rules for resolver optimization, query performance, data fetching patterns, and schema design, prioritized by impact to guide automated refactoring and code generation.

## When to Apply

Reference these guidelines when:
- Writing GraphQL schemas, resolvers, or type definitions
- Implementing data fetching and resolver logic
- Reviewing GraphQL code for performance issues
- Refactoring existing GraphQL APIs
- Optimizing query execution or resolver performance
- Designing GraphQL server architecture

## Rule Categories by Priority

| Priority | Category | Impact | Prefix |
|----------|----------|--------|--------|
| 1 | Query Optimization | CRITICAL | `dataloader-` |
| 2 | Schema Design | CRITICAL-HIGH | `schema-` |
| 3 | Mutation Design | CRITICAL-HIGH | `mutation-` |
| 4 | Pagination | HIGH | `pagination-` |
| 5 | Security | CRITICAL-MEDIUM | `security-` |
| 6 | Operations | MEDIUM | `operations-` |

## Quick Reference

- `dataloader-n-plus-one` - Use DataLoader to batch queries and prevent N+1 performance issues
- `query-unique-identifiers` - Use unique identifiers over composite parameters to simplify API surface
- `schema-no-json-filters` - Ban arbitrary JSON filter scalars to prevent NoSQL injection vulnerabilities
- `schema-no-binary-data` - Avoid large binary data in schema to prevent payload bloat and memory issues
- `schema-stable-identifiers` - Use globally stable opaque identifiers to prevent information leakage and enumeration attacks
- `schema-structured-types` - Use structured types over unstructured String/JSON fields to improve type safety
- `schema-split-types-by-role` - Split types by role to prevent privacy field leakage and eliminate runtime authorization
- `schema-prefer-deprecation` - Prefer deprecation over versioning to enable continuous API evolution
- `schema-field-overload` - Avoid field overloads for viewer vs user to prevent security issues and improve API clarity
- `schema-minimize-nullable-args` - Minimize nullable arguments to improve API clarity and type safety
- `schema-no-duplicate-fields` - Prevent duplicate fields accessible through nested objects to maintain single source of truth
- `mutation-no-file-uploads` - Avoid file uploads through GraphQL to prevent memory exhaustion and security vulnerabilities
- `mutation-single-input-object` - Use single input object argument instead of multiple scalars to improve API evolvability
- `mutation-union-result-types` - Return union types with dedicated success and specific error types for type-safe error handling
- `mutation-explicit-actions` - Design mutations around explicit actions rather than generic update patterns
- `mutation-separate-input-types` - Separate input types for create and update to improve type safety
- `mutation-avoid-validation-scalars` - Avoid custom validation scalars to prevent multi-request error loops
- `pagination-no-default-totalcount` - Avoid default totalCount in connections to prevent performance degradation
- `security-complexity-limits` - Require complexity and query node limits to prevent resource exhaustion attacks
- `security-disable-introspection` - Disable introspection in production to prevent schema disclosure
- `operations-require-client-headers` - Require client identification headers for debugging and monitoring

## How to Use

Read individual rule files for detailed explanations and code examples:

```
rules/dataloader-n-plus-one.md
rules/query-unique-identifiers.md
rules/schema-no-json-filters.md
rules/schema-no-binary-data.md
rules/schema-stable-identifiers.md
rules/schema-structured-types.md
rules/schema-split-types-by-role.md
rules/schema-prefer-deprecation.md
rules/schema-field-overload.md
rules/schema-minimize-nullable-args.md
rules/schema-no-duplicate-fields.md
rules/mutation-no-file-uploads.md
rules/mutation-single-input-object.md
rules/mutation-union-result-types.md
rules/mutation-explicit-actions.md
rules/mutation-separate-input-types.md
rules/mutation-avoid-validation-scalars.md
rules/pagination-no-default-totalcount.md
rules/security-complexity-limits.md
rules/security-disable-introspection.md
rules/operations-require-client-headers.md
```

Each rule file contains:
- Brief explanation of why it matters
- When to use and when not to use the pattern
- Implementation requirements
- Incorrect code example with explanation
- Correct code example with explanation
- Additional context and references

© wispbit · MIT · wispbit-ai/skills

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

Все скиллы по теме «Бэкенд и API» →
graphql Mindrally Скилл graphql для Claude Code помогает проектировать GraphQL-схемы и оптимизировать запросы. Включается при разработке API и интеграции GraphQL-клиентов. CX Codex +1 726установок graphql-schema apollographql Скилл graphql-schema обучает проектированию схем GraphQL SDL по практикам Apollo. Помогает при создании schema.graphql, добавлении мутаций или настройке пагинации. CX Codex +1 4 500установок graphql-expert martinholovsky Скилл graphql-expert для Claude Code помогает проектировать GraphQL-схемы, писать резолверы и настраивать федерацию. Он включается при разработке API, работе с Apollo Server и оптимизации запросов. CX Codex +1 220установок graphql-architect sickn33 Скилл graphql-architect для Claude Code помогает проектировать GraphQL-схемы, федерацию и API с учётом производительности и безопасности. Он подключается к задачам по архитектуре GraphQL. CX Codex +1 5установок graphql-implementation secondsky Скилл graphql-implementation для Claude Code проектирует схемы GraphQL, пишет резолверы, настраивает DataLoader и обработку ошибок. Применяется при создании API, переходе с REST и настройке подписок. CX Codex +1 400установок graphql-schema-designer patricio0312rev Скилл graphql-schema-designer для Claude Code помогает спроектировать GraphQL API с типами, запросами, мутациями, подписками и резолверами. Включается по запросам о схеме, настройке GraphQL или Apollo Server. CX Codex +1 230установок

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

sqlalchemy-alembic-expert-best-practices-code-review Скилл sqlalchemy-alembic-expert-best-practices-code-review для Claude Code помогает писать и проверять модели SQLAlchemy, миграции Alembic и запросы к БД. Активируется при изменениях схемы и оптимизации запросов. CX Codex +1 2 200установок python-expert-best-practices-code-review Скилл python-expert-best-practices-code-review для Claude Code и других агентов: восемь правил Python по обработке ошибок, типичным багам и читаемости. Проверяет код при ревью и рефакторинге. CX Codex +1 692установок postgresql-expert-best-practices-code-review Скилл postgresql-expert-best-practices-code-review для Claude Code содержит правила по схемам, миграциям и индексам PostgreSQL. Агент использует их при написании и правке миграций. CX Codex +1 392установок rust-expert-best-practices-code-review Скилл rust-expert-best-practices-code-review для Claude Code даёт агенту правила идиоматичного Rust при написании, ревью и рефакторинге кода: типы, обработка ошибок, итераторы и дизайн API. CX Codex +1 258установок

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

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