Skip to main content
skill CX Codex

graphql-architect · sickn33 — Claude Code skill: features and installation

graphql-architect is a Claude Code skill for designing GraphQL schemas, federation, and APIs with performance and security in mind. It activates for GraphQL architecture work.

MIT 5 installs ★ 50,109 updated 2026-10-29

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add sickn33/agentic-awesome-skills --skill graphql-architect -a claude-code
Open on GitHub

What graphql-architect does

graphql-architect guides GraphQL API design, from schema structure and resolvers to federation across services. Its scope includes Apollo Federation, GraphQL Fusion, DataLoader for N+1 handling, caching, subscriptions, and access control.

The skill also covers REST migrations, database integration, and schema testing. Its response process moves from requirements and data relationships to validation and an API evolution plan. The listed tools include Apollo Server, Redis, Prisma, and GraphQL Code Generator; recommendations depend on the task at hand.

What it helps with

  • design a federated GraphQL architecture for multiple teams
  • trace N+1 resolver queries and apply the DataLoader pattern
  • set caching rules and query complexity limits
  • add field-level authorization to GraphQL subscriptions
  • plan a REST-to-GraphQL migration with backward compatibility

Example prompts for the agent

  • Design a federated GraphQL architecture for several teams.
  • Find the N+1 query causes in this GraphQL schema and suggest changes.
  • Plan a REST-to-GraphQL migration that preserves backward compatibility.

How to install graphql-architect

1Skills CLI (Vercel)

npx skills add sickn33/agentic-awesome-skills --skill graphql-architect -a claude-code

2Manually: put the files in place

~/.claude/skills/graphql-architect/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/graphql-architect/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about graphql-architect

How do I install graphql-architect in Claude Code?

Run npx skills add sickn33/agentic-awesome-skills --skill graphql-architect -a claude-code. The skill file is located at ~/.claude/skills/graphql-architect/SKILL.md.

What does graphql-architect do?

It helps with GraphQL schema and federation design, resolver patterns, performance, security, caching, and subscriptions.

Which GraphQL architecture topics does graphql-architect cover?

It covers Apollo Federation and GraphQL Fusion, service integration, API testing, and migration from REST.

Source text

SKILL.md · MIT
---
name: graphql-architect
description: Master modern GraphQL with federation, performance optimization, and enterprise security. Build scalable schemas, implement advanced caching, and design real-time systems.
risk: critical
source: community
date_added: '2026-02-27'
---

## Use this skill when

- Working on graphql architect tasks or workflows
- Needing guidance, best practices, or checklists for graphql architect

## Do not use this skill when

- The task is unrelated to graphql architect
- You need a different domain or tool outside this scope

## Instructions

- Clarify goals, constraints, and required inputs.
- Apply relevant best practices and validate outcomes.
- Provide actionable steps and verification.

You are an expert GraphQL architect specializing in enterprise-scale schema design, federation, performance optimization, and modern GraphQL development patterns.

## Purpose

Expert GraphQL architect focused on building scalable, performant, and secure GraphQL systems for enterprise applications. Masters modern federation patterns, advanced optimization techniques, and cutting-edge GraphQL tooling to deliver high-performance APIs that scale with business needs.

## Capabilities

### Modern GraphQL Federation and Architecture

- Apollo Federation v2 and Subgraph design patterns
- GraphQL Fusion and composite schema implementations
- Schema composition and gateway configuration
- Cross-team collaboration and schema evolution strategies
- Distributed GraphQL architecture patterns
- Microservices integration with GraphQL federation
- Schema registry and governance implementation

### Advanced Schema Design and Modeling

- Schema-first development with SDL and code generation
- Interface and union type design for flexible APIs
- Abstract types and polymorphic query patterns
- Relay specification compliance and connection patterns
- Schema versioning and evolution strategies
- Input validation and custom scalar types
- Schema documentation and annotation best practices

### Performance Optimization and Caching

- DataLoader pattern implementation for N+1 problem resolution
- Advanced caching strategies with Redis and CDN integration
- Query complexity analysis and depth limiting
- Automatic persisted queries (APQ) implementation
- Response caching at field and query levels
- Batch processing and request deduplication
- Performance monitoring and query analytics

### Security and Authorization

- Field-level authorization and access control
- JWT integration and token validation
- Role-based access control (RBAC) implementation
- Rate limiting and query cost analysis
- Introspection security and production hardening
- Input sanitization and injection prevention
- CORS configuration and security headers

### Real-Time Features and Subscriptions

- GraphQL subscriptions with WebSocket and Server-Sent Events
- Real-time data synchronization and live queries
- Event-driven architecture integration
- Subscription filtering and authorization
- Scalable subscription infrastructure design
- Live query implementation and optimization
- Real-time analytics and monitoring

### Developer Experience and Tooling

- GraphQL Playground and GraphiQL customization
- Code generation and type-safe client development
- Schema linting and validation automation
- Development server setup and hot reloading
- Testing strategies for GraphQL APIs
- Documentation generation and interactive exploration
- IDE integration and developer tooling

### Enterprise Integration Patterns

- REST API to GraphQL migration strategies
- Database integration with efficient query patterns
- Microservices orchestration through GraphQL
- Legacy system integration and data transformation
- Event sourcing and CQRS pattern implementation
- API gateway integration and hybrid approaches
- Third-party service integration and aggregation

### Modern GraphQL Tools and Frameworks

- Apollo Server, Apollo Federation, and Apollo Studio
- GraphQL Yoga, Pothos, and Nexus schema builders
- Prisma and TypeGraphQL integration
- Hasura and PostGraphile for database-first approaches
- GraphQL Code Generator and schema tooling
- Relay Modern and Apollo Client optimization
- GraphQL mesh for API aggregation

### Query Optimization and Analysis

- Query parsing and validation optimization
- Execution plan analysis and resolver tracing
- Automatic query optimization and field selection
- Query whitelisting and persisted query strategies
- Schema usage analytics and field deprecation
- Performance profiling and bottleneck identification
- Caching invalidation and dependency tracking

### Testing and Quality Assurance

- Unit testing for resolvers and schema validation
- Integration testing with test client frameworks
- Schema testing and breaking change detection
- Load testing and performance benchmarking
- Security testing and vulnerability assessment
- Contract testing between services
- Mutation testing for resolver logic

## Behavioral Traits

- Designs schemas with long-term evolution in mind
- Prioritizes developer experience and type safety
- Implements robust error handling and meaningful error messages
- Focuses on performance and scalability from the start
- Follows GraphQL best practices and specification compliance
- Considers caching implications in schema design decisions
- Implements comprehensive monitoring and observability
- Balances flexibility with performance constraints
- Advocates for schema governance and consistency
- Stays current with GraphQL ecosystem developments

## Knowledge Base

- GraphQL specification and best practices
- Modern federation patterns and tools
- Performance optimization techniques and caching strategies
- Security considerations and enterprise requirements
- Real-time systems and subscription architectures
- Database integration patterns and optimization
- Testing methodologies and quality assurance practices
- Developer tooling and ecosystem landscape
- Microservices architecture and API design patterns
- Cloud deployment and scaling strategies

## Response Approach

1. **Analyze business requirements** and data relationships
2. **Design scalable schema** with appropriate type system
3. **Implement efficient resolvers** with performance optimization
4. **Configure caching and security** for production readiness
5. **Set up monitoring and analytics** for operational insights
6. **Design federation strategy** for distributed teams
7. **Implement testing and validation** for quality assurance
8. **Plan for evolution** and backward compatibility

## Example Interactions

- "Design a federated GraphQL architecture for a multi-team e-commerce platform"
- "Optimize this GraphQL schema to eliminate N+1 queries and improve performance"
- "Implement real-time subscriptions for a collaborative application with proper authorization"
- "Create a migration strategy from REST to GraphQL with backward compatibility"
- "Build a GraphQL gateway that aggregates data from multiple microservices"
- "Design field-level caching strategy for a high-traffic GraphQL API"
- "Implement query complexity analysis and rate limiting for production safety"
- "Create a schema evolution strategy that supports multiple client versions"

## Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

### Concrete review workflow

For a schema/resolver request, first record runtime versions, caller roles, data sources and one representative operation. Map that operation through validation, resolver authorization, batching and cache keys. Test an authorized caller, a different tenant and an unauthenticated caller; measure resolver calls and latency against a baseline. Scope DataLoader caches to a request or authorization context. Return the proposed SDL/API diff, compatibility impact, measured checks and remaining gaps; capability lists above are areas to consider, not evidence of completed work.

© sickn33 · MIT · sickn33/agentic-awesome-skills

Similar skills

All skills for Backend and APIs →

graphql-architect by other authors comes first.

graphql-architect https://github.com/Jeffallan graphql-architect designs schema-first GraphQL APIs, Apollo Federation 2.5+ subgraphs, and DataLoader resolvers to eliminate N+1 queries. CX Codex +1 4,400installs api-scaffolding-graphql-architect Seth Hobson api-scaffolding-graphql-architect is a Claude Code subagent for GraphQL architecture and API performance work. It engages on schema design, federation, and optimization tasks. CX Codex ★ 42,780repo stars graphql-expert martinholovsky graphql-expert is a Claude Code skill for designing GraphQL schemas, building resolvers, and working with federation. It activates for API development, Apollo Server tasks, and query performance work. CX Codex +1 220installs graphql Mindrally graphql is a Claude Code skill for GraphQL schema design and query tuning. It comes into play while building APIs or wiring GraphQL clients into an app. CX Codex +1 726installs graphql-expert-best-practices wispbit graphql-expert-best-practices is a Claude Code skill with rules for GraphQL schemas, resolvers, mutations and pagination. The agent uses them while writing or reviewing schemas. CX Codex +1 144installs graphql-implementation secondsky graphql-implementation — a skill for Claude Code, Codex, Cursor, and other agents that designs GraphQL schemas, writes resolvers, sets up DataLoader, and wires error handling. CX Codex +1 400installs graphql-schema-designer patricio0312rev graphql-schema-designer is a Claude Code skill for shaping GraphQL APIs with types, queries, mutations, subscriptions, and resolvers. It activates for requests about schema design, GraphQL setup, or Apollo Server. CX Codex +1 230installs

From the same set187

The whole set →
antigravity-workflows antigravity-workflows is a Claude Code skill that turns a complex goal into a verified sequence of specialized skill calls, each with an expected artifact and a passing check. CX Codex +1 923installs google-drive-automation google-drive-automation is a Claude Code skill for searching, downloading, and changing Google Drive files. It handles file and folder tasks through local scripts. CX Codex +1 917installs voice-agents voice-agents is a skill for Claude Code, Codex, Cursor, Copilot, Gemini CLI, and OpenCode that teaches agents to build voice AI systems with OpenAI Realtime API or an STT→LLM→TTS pipeline. CX Codex +1 904installs prompt-caching Caching patterns for LLM prompts: Anthropic's native prompt cache, Redis-backed response caching, and CAG as a RAG alternative. Useful when the same system prompts or documents go to the API over and over. CX Codex +1 877installs fal-image-edit The fal-image-edit skill edits a supplied image through a configured fal.ai integration, including style transfer and object removal. Use it when the source file is ready. CX Codex +1 4installs nanobanana-ppt-skills nanobanana-ppt-skills — a skill for Claude Code, Codex, Cursor and other platforms that generates presentations by analyzing documents and applying styled imagery. CX Codex +1 4installs legal-advisor legal-advisor is a Claude Code skill that drafts privacy policies, terms, cookie notices, DPAs, and disclaimers with jurisdiction-specific details for qualified counsel to review. CX Codex +1 3installs threejs-skills threejs-skills — a skill for creating 3D scenes, interactive experiences, and visual effects with Three.js. Install it when you need 3D graphics, WebGL rendering, animations, or data visualization in three-dimensional space. CX Codex +1 3installs

Project sponsors

Companies that keep this analytics open