skills.vishalvoidskills/vishalvoid
Creative & DesignBeginner

graphql-schema

Reference guide for designing clean, evolvable GraphQL schemas

Developer Setup

Setup & Installation

bash
npx skills add https://github.com/apollographql/skills --skill graphql-schema

Overview

What This Skill Does

Reference guide for designing clean, evolvable GraphQL schemas

Application

When to use this Skill

Documentation

Show Skills.md file

GraphQL Schema Design Guide

This guide covers best practices for designing GraphQL schemas that are intuitive, performant, and maintainable. Schema design is primarily a server-side concern that directly impacts API usability.

Schema Design Principles

1. Design for Client Needs

  • Think about what queries clients will write
  • Organize types around use cases, not database tables
  • Expose capabilities, not implementation details

2. Be Explicit

  • Use clear, descriptive names
  • Make nullability intentional
  • Document with descriptions

3. Design for Evolution

  • Plan for backwards compatibility
  • Use deprecation before removal
  • Avoid breaking changes

Quick Reference

Lines 1 - 25 of 155

Recommendations

Explore other random skills

All skillsMy patterns