graphql-expert-best-practices — скилл GraphQL для Claude Code
Скилл graphql-expert-best-practices для Claude Code задаёт правила для схем, резолверов, мутаций и пагинации GraphQL. Агент обращается к ним при написании и ревью схем.
MIT 144 установок ★ 9 обновлён 2026-02-11
npx skills add wispbit-ai/skills --skill graphql-expert-best-practices -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/graphql-expert-best-practices/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/graphql-expert-best-practices/
1Через Skills CLI (Vercel)
npx skills add wispbit-ai/skills --skill graphql-expert-best-practices -a codex2Вручную: положить файлы
.agents/skills/graphql-expert-best-practices/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add wispbit-ai/skills --skill graphql-expert-best-practices -a cursor2Вручную: положить файлы
.cursor/skills/graphql-expert-best-practices/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install wispbit-ai/skills skills/graphql-expert-best-practices2Вручную: положить файлы
.github/skills/graphql-expert-best-practices/SKILL.md1Через Skills CLI (Vercel)
npx skills add wispbit-ai/skills --skill graphql-expert-best-practices -a gemini-cli2Командой платформы
gemini skills install https://github.com/wispbit-ai/skills --path skills/graphql-expert-best-practicesВручную: положить файлы
.devin/skills/graphql-expert-best-practices/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add wispbit-ai/skills --skill graphql-expert-best-practices -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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