graphql-expert
GraphQL API expertise from Meta - the company that created GraphQL. Build efficient, type-safe APIs with powerful querying capabilities. Use when building GraphQL APIs, implementing GraphQL clients, o
SKILL.md.claude/skills/graphql-expert/SKILL.md
GitHubGraphQL Expert - Meta Created GraphQL
Expert: Sarah Chen (Meta React Core Team, 12 years) Level: 9/10 - Meta created GraphQL in 2012
Overview
GraphQL from Meta (Facebook) - created to solve API inefficiencies at scale. Used by Instagram, Facebook, GitHub, Shopify, and thousands of companies.
Why Meta Created GraphQL (2012)
The Problem:
- Facebook mobile app made 100+ REST API calls per screen
- Over-fetching: Getting data you don't need
- Under-fetching: Making multiple requests for related data
- API versioning nightmare (v1, v2, v3...)
The Solution: GraphQL
- Client specifies exactly what data it needs
- One request, all data
- Strongly typed schema
- No versioning needed
Core Workflow
- Define schema - GraphQL types and relationships (see references/schema.md)
- Implement resolvers - Business logic to fetch data (see references/resolvers.md)
- Client queries - Fetch exactly what you need (see references/client.md)
- Optimize - DataLoader for N+1 prevention (see references/optimization.md)
Key Concepts
Schema-First Development
Define your API contract in GraphQL schema language, then implement resolvers.
DataLoader Pattern
Meta created DataLoader to solve N+1 query problems. See references/optimization.md for details.
Relay Cursor Connections
Meta's pattern for pagination in GraphQL. See references/schema.md for implementation.
Meta's GraphQL at Scale
- 3 billion users
- GraphQL replaced 100+ REST endpoints
- Single GraphQL endpoint handles all data
- Relay for efficient data fetching
- Largest GraphQL deployment
- Thousands of types in schema
- Billions of queries per day
- Relay Compiler for optimization
Best Practices
- Use Relay Cursor Connections for pagination
- DataLoader for N+1 prevention
- Strongly typed schema with TypeScript
- Persisted queries for security
- Query complexity limits to prevent abuse
Related Skills
- react-expert - React + GraphQL
- typescript-master - Type-safe GraphQL
- node-backend - GraphQL server
Last Updated: 2026-02-03 Expert: Sarah Chen (Meta, 12 years) - Meta created GraphQL