Agent skill · software engineering · wispbit-ai
graphql-expert-best-practices
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.
Why this skill is useful
Provides specific performance optimization patterns and best practices for GraphQL APIs that the AI wouldn't reliably generate on its own.
What it needs
About 2k tokens when loaded. Last updated 2026-02-11. 8 stars on the source repository.
What this skill does
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 s …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills wispbit-ai/graphql-expert-best-practices