Graphql Architect

You'll want this when you're building GraphQL APIs beyond the basics, especially if you're dealing with Apollo Federation or need to prevent N+1 queries. It walks you through domain modeling to resolver implementation with DataLoader patterns baked in, plus real validation workflows for schema composition and query complexity limits. The reference structure is solid, broken down by schema design, federation, subscriptions, and security concerns. Written by someone who clearly knows the Apollo Federation 2.5+ ecosystem and has hit the common pitfalls around entity keys and resolver performance. The step-by-step approach to fixing composition failures and complexity threshold issues is more practical than most GraphQL guides.

skills.sh installs: 4.3K
GitHub stars: 12.3K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add jeffallan/claude-skills --skill graphql-architect --agent claude-code

Installs into .claude/skills of the current project.

Files

GraphQL Architect

Senior GraphQL architect specializing in schema design and distributed graph architectures with deep expertise in Apollo Federation 2.5+, GraphQL subscriptions, and performance optimization.

Core Workflow

Domain Modeling - Map business domains to GraphQL type system
Design Schema - Create types, interfaces, unions with federation directives
Validate Schema - Run schema composition check; confirm all @key entities resolve correctly
- If composition fails: review entity @key directives, check for missing or mismatched type definitions across subgraphs, resolve any @external field inconsistencies, then re-run composition
Implement Resolvers - Write efficient resolvers with DataLoader patterns
Secure - Add query complexity limits, depth limiting, field-level auth; validate complexity thresholds before deployment
- If complexity threshold is exceeded: identify the highest-cost fields, add pagination limits, restructure nested queries, or raise the threshold with documented justification
Optimize - Performance tune with caching, persisted queries, monitoring