Graphql Schema Design

GraphQL type systems, queries, mutations, subscriptions, and schema design patterns.

48 stars 10 forksOther Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add sethdford/claude-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add sethdford/claude-skills --skill graphql-schema-design
Manual install
git clone --depth 1 https://github.com/sethdford/claude-skills.git /tmp/claude-skills
mkdir -p ~/.claude/skills
cp -r /tmp/claude-skills/engineer/api-development/skills/graphql-schema-design ~/.claude/skills/graphql-schema-design

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# GraphQL Schema Design

Designing GraphQL schemas for flexible, efficient APIs.

## Context

You are designing a GraphQL schema. Think about types, fields, queries, mutations.

## Domain Context

- **Types**: Nouns (User, Order, Product); fields are attributes
- **Queries**: Read operations; no side effects
- **Mutations**: Write operations; return results
- **Subscriptions**: Real-time updates via WebSocket
- **Fragments**: Reusable selections; avoid duplication

## Instructions

1. **Define Types**: User, Order, Product; what fields do they have?
2. **Design Queries**: Root query type; what can clients read?
3. **Design Mutations**: Root mutation type; what can clients change?
4. **Use Enums**: For fixed sets of values (OrderStatus, Role)
5. **Use Interfaces**: For shared fields across types (Node interface)
6. **Plan Subscriptions**: Real-time updates? What events?
7. **Document Null**: Mark required fields with !

## Anti-Patterns

- Over-nesting types; leads to N+1 query problems
- Allowing mutations without auth checks; easy backdoors
- No rate limiting on mutations; clients can spam writes
- Exposing internal IDs directly; abstract away
- Not planning pagination; large result sets kill performance

## Further Reading

- GraphQL spec and best practices
- Apollo GraphQL docs
- Hasura GraphQL patterns
Read the full skill on GitHub

Details

Skill name
graphql-schema-design
Path
engineer/api-development/skills/graphql-schema-design/SKILL.md
License
MIT
Repo updated
11 March 2026

FAQ

What does the Graphql Schema Design skill do?

GraphQL type systems, queries, mutations, subscriptions, and schema design patterns.

How do I install the Graphql Schema Design skill?

Claude Code plugin: /plugin marketplace add sethdford/claude-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Graphql Schema Design popular?

It lives in sethdford/claude-skills, which has 48 GitHub stars and 10 forks.

Related skills

Browse the most popular Claude skills, all other skills, or write your own with the skills generator.