What pagination style does this skill recommend?

It enforces Relay-style cursor pagination using edges, nodes, and PageInfo to ensure scalability and prevent performance issues associated with large, unbounded lists.

How does it handle nullability in schemas?

The skill follows the 'nullable by default' principle, recommending fields be made required only when strictly necessary to allow for easier API evolution without breaking changes.

How does it manage API versioning?

Instead of versioning, it guides you through using the @deprecated directive with specific reasons, providing a clear migration path for clients before fields are removed.

Can it help with naming conventions?

Yes, it enforces PascalCase for types and camelCase for fields, ensuring a consistent and professional schema structure that aligns with community standards.

Does it support API documentation?

Absolutely, it emphasizes that the schema is the documentation, encouraging descriptions for all types, fields, and arguments to improve client-side discovery.

GraphQL Schema Design

Name: GraphQL Schema Design
Author: jovermier

byjovermier

0•

API開発

Architect robust, scalable GraphQL schemas using industry best practices like Relay pagination and intentional nullability.

This skill empowers Claude to act as a senior GraphQL architect, providing expert guidance on schema construction, type systems, and API evolution. It enforces consistent naming conventions, standardized pagination patterns, and comprehensive documentation to ensure that your GraphQL API is discoverable, performant, and maintainable. Use this skill when building new APIs or refactoring existing schemas to avoid common pitfalls like unbounded lists, inconsistent nullability, or breaking changes without deprecation paths.

主な機能

01Guides intentional nullability to prevent future breaking schema changes

02Standardizes mutation patterns using the industry-standard noun-plus-verb approach

03Implements Relay-style cursor pagination for efficient data fetching

040 GitHub stars

05Enforces consistent PascalCase for types and camelCase for fields

06Integrates comprehensive schema documentation and deprecation strategies

ユースケース

01Defining complex mutations and object types while maintaining strict design consistency

02Designing a new GraphQL API from scratch with a scalable, production-ready architecture

03Refactoring legacy schemas to implement standardized pagination and naming conventions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jovermier/cc-stack-marketplace graphql-schema-design

For use in Claude.ai and ChatGPT

Download Skill