graphql-docs

GraphQL questions are easy to answer from stale memory or REST-centric assumptions. Use this skill to ground answers in the official GraphQL documentation at graphql.org and return the closest authoritative page instead of generic API advice.

When to Use

Use this skill when the request is about:

• GraphQL concepts, terminology, and how GraphQL compares to REST
• Schema definition language (SDL), types, fields, arguments, and nullability
• Queries, mutations, subscriptions, variables, fragments, aliases, and directives
• Validation rules, execution, resolvers, and response formats (data, errors, extensions)
• Introspection, __typename, and schema exploration
• Serving GraphQL over HTTP, request/response formats, and status codes
• Authorization, pagination, schema design, and global object identification
• Caching, performance (N+1, batching, DataLoader), and security
• Federation, subgraphs, gateways, and composite schemas
• Building robust clients that handle schema evolution
• GraphQL.js, the specification, and FAQ topics on graphql.org

Do not use this skill for:

• NestJS GraphQL module setup and decorators. Use nestjs-docs instead.
• Apollo Server, Yoga, Hasura, or other vendor-specific server docs unless graphql.org links to them.
• Raw Express or Fastify HTTP setup without GraphQL context. Use expressjs-docs or fastify-docs instead.

Workflow

1. Classify the request

Decide which bucket the question belongs to before searching:

• Getting started and core concepts
• Schemas, types, and SDL
• Operations (queries, mutations, subscriptions)
• Request lifecycle (validation, execution, response)
• Introspection and tooling
• Best practices (HTTP, auth, pagination, schema design)
• Performance, caching, and security
• Federation and distributed schemas
• Client robustness and schema evolution
• Specification and FAQ

If you need a quick starting point, load references/topic-map.md and jump to the closest section.

2. Search official GraphQL docs first