skills.rest
kamelmh
kamelmhCOMMUNITY
Explore all skills by this author →
GitHub

graphql-architect

Design GraphQL schemas, federation boundaries, resolvers, and subscription APIs.

Updated Aug 27, 2026
Search Tags:#subscriptions#graphql#query-optimization#dataloader#schema-design#apollo-federation#api-architecture
One-click install
npx skills add https://github.com/kamelmh/opencode-config --skill graphql-architect-kamelmh
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: graphql-architect
Source: https://github.com/kamelmh/opencode-config/tree/main/skills/graphql-architect
Command: npx skills add https://github.com/kamelmh/opencode-config --skill graphql-architect-kamelmh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps teams design and evolve GraphQL APIs that are scalable, consistent, and safe to operate. It reduces schema sprawl, resolver inefficiency, and federation mistakes by giving clear guidance for API architecture decisions.

Core Features & Use Cases

  • Schema Design: Define types, interfaces, unions, inputs, enums, and custom scalars with strong naming and nullability practices.
  • Federation: Plan Apollo Federation subgraphs, entity keys, directives, gateway composition, and cross-service ownership.
  • Resolvers & Performance: Implement resolvers with DataLoader, avoid N+1 queries, optimize query planning, and handle pagination cleanly.
  • Security & Operations: Add depth limits, complexity analysis, authentication, authorization, allowlisting, and subscription safeguards.
  • Use Case: Use this Skill when migrating a REST API to GraphQL, introducing real-time subscriptions, or coordinating a distributed supergraph across multiple services.

Quick Start

Ask the GraphQL Architect skill to design a GraphQL schema for your domain, include federation and resolver guidance, and provide secure example queries for the operations you need.

Frequently Asked Questions about graphql-architect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design a production-ready GraphQL schema for a distributed API system?▼

Design production-ready GraphQL schemas by defining types, interfaces, and unions using schema-first SDL, ensuring strong naming, correct nullability, and documented examples for distributed API systems.

How do I prevent N+1 queries in GraphQL resolvers?▼

Prevent N+1 queries in GraphQL resolvers by implementing DataLoader batching, which groups multiple requests into a single batch fetch to optimize query planning and database access.

What is the best way to plan Apollo Federation subgraphs and gateway composition?▼

Plan Apollo Federation by defining subgraph entity keys and directives, establishing cross-service ownership boundaries, and configuring gateway composition to build a unified supergraph.

How do I migrate a REST API to GraphQL safely?▼

Migrate a REST API to GraphQL by mapping existing endpoints to schema types, inputs, and custom scalars, then implementing resolvers with DataLoader batching to ensure clean query optimization.

How do I secure GraphQL APIs against malicious queries and unauthorized access?▼

Secure GraphQL APIs by implementing query depth limits, complexity analysis, authentication, authorization, and allowlisting to prevent overly expensive queries and safeguard operations.

Can I use this to design real-time GraphQL subscriptions with proper safeguards?▼

Design real-time GraphQL subscriptions by defining subscription types in the schema and applying robust error handling and subscription safeguards to ensure stable live data delivery.

Related Skills

Explore More Software Engineering Skills→
HsnSaboorHsnSaboor

apollo-connectors

Integrate REST APIs into GraphQL supergraphs using Apollo Connectors.

Community
Advanced
enigmaicon-engenigmaicon-eng
1

graphql-architect

Design GraphQL schemas for Apollo Federation with DataLoader resolvers and query limits.

Community
Advanced
lamb92009lamb92009

graphql-architect

Design GraphQL schemas with Apollo Federation and real-time subscriptions.

Community
Advanced
NickCrewNickCrew
29

api-gateway-patterns

Implement API gateway routing, authentication, and traffic management for microservices.

Community
Intermediate