graphql-operations
Installation
Summary
Best practices guide for writing efficient, type-safe GraphQL operations and organizing them with fragments.
- Covers queries, mutations, subscriptions, and fragments with naming conventions, variable syntax, and directive usage
- Emphasizes core principles: request only needed fields, name all operations, use variables instead of hardcoded values, and include
idfields for cacheability - Recommends colocating fragments with components and using
@include/@skipdirectives for conditional field selection - Compatible with any GraphQL client (Apollo Client, urql, Relay) and includes reference documentation for queries, mutations, fragments, variables, and tooling
SKILL.md
GraphQL Operations Guide
This guide covers best practices for writing GraphQL operations (queries, mutations, subscriptions) as a client developer. Well-written operations are efficient, type-safe, and maintainable.
Operation Basics
Query Structure
query GetUser($id: ID!) {
user(id: $id) {
id
name
email
}
}
Mutation Structure
Related skills