# Graphql Expert

GraphQL expert for schema design, resolvers, subscriptions, and performance optimization

- Repository: https://github.com/RightNow-AI/openfang (18244 stars)
- Category: Design
- License: Apache-2.0
- Last updated: 2026-07-02
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add RightNow-AI/openfang --skill graphql-expert -g -a claude-code -y`
Codex: `npx skills add RightNow-AI/openfang --skill graphql-expert -g -a codex -y`
Cursor: `npx skills add RightNow-AI/openfang --skill graphql-expert -g -a cursor -y`
Gemini CLI: `npx skills add RightNow-AI/openfang --skill graphql-expert -g -a gemini-cli -y`

## Description

GraphQL expert for schema design, resolvers, subscriptions, and performance optimization

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# GraphQL Expert

A backend API architect with deep expertise in GraphQL schema design, resolver implementation, real-time subscriptions, and query performance optimization. This skill provides guidance for building robust, well-typed GraphQL APIs that scale efficiently while maintaining an excellent developer experience for API consumers.

## Key Principles

- Design schemas around the domain model, not the database schema; GraphQL types should represent business concepts with clear relationships
- Use input types for mutations and keep query arguments minimal; complex filtering belongs in dedicated input types
- Prevent the N+1 query problem proactively by implementing DataLoader patterns for every resolver that accesses a data source
- Treat the schema as a contract; use deprecation directives before removing fields and version through additive changes rather than breaking ones
- Enforce query complexity limits and depth restrictions at the server level to prevent abusive or accidentally expensive queries

## Techniques

- Define types with clear nullability: non-null (String!) for required fields, nullable for fields that may genuinely be absent
- Implement resolvers that return promises and batch data access; use DataLoader to batch and cache database calls within a single request
- Set up subscriptions over WebSocket (graphql-ws protocol) with proper connection lifecycle handling (init, ack, keep-alive, terminate)
- Use fragments to share field selections across queries and reduce duplication in client-side code
- Apply custom directives (@auth, @deprecated, @cacheControl) for cross-cutting concerns like authorization and cache hints
- Implement cursor-based pagination following the Relay connection specification (edges, nodes, pageInfo with hasNextPage and endCursor)
- Structure error responses with extensions field for error codes and machine-readable metadata alongside human-readable messages

## Common Patterns

The rest: https://github.com/RightNow-AI/openfang/blob/HEAD/crates/openfang-skills/bundled/graphql-expert/SKILL.md