How does this skill handle GraphQL file organization?

It advocates for the colocation pattern, where .graphql files are stored in a subdirectory within the component folder they belong to (e.g., components/UserCard/graphql/fragment.UserCard.graphql).

Does this skill help with GraphQL naming conventions?

Yes, it provides specific patterns like [Action][Resource]Query for queries and [Verb][Target]Mutation for mutations to maintain consistency across the codebase.

What is the graphql-guide skill?

It is a specialized capability for Claude Code that provides domain-specific guidance for GraphQL development, focusing on naming conventions and file organization.

What is the 'Fragment First' approach mentioned in the guide?

It is a pattern where UI components define their own data requirements using fragments, which are then aggregated into parent queries, ensuring clear data responsibility.

GraphQL Best Practices Guide

Name: GraphQL Best Practices Guide
Author: simula-labs

bysimula-labs

0•

API Development

Standardizes GraphQL development through strictly enforced naming conventions, file organization patterns, and fragment-first architecture.

The GraphQL Best Practices Guide provides Claude with a comprehensive framework for developing clean, maintainable, and scalable GraphQL implementations. It defines rigorous naming patterns for Fragments, Queries, and Mutations, enforces a standardized file naming system, and promotes the 'colocation pattern' where GraphQL files reside near their respective components. By implementing a fragment-first approach and a predefined set of mutation verbs, this skill ensures that data responsibilities are clearly defined and that the codebase remains consistent across large-scale projects.

Key Features

01Specific file naming conventions for GraphQL resource types

02Standardized mutation verb dictionary (Create, Update, Add, etc.)

030 GitHub stars

04Fragment-first workflow implementation for modular data fetching

05Standardized naming patterns for fragments, queries, and mutations

06Component-based colocation guidelines for better project structure

Use Cases

01Refactoring existing GraphQL files into a structured colocation pattern

02Defining new GraphQL fragments and queries for frontend components

03Onboarding developers to a consistent naming standard for API interactions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add simula-labs/claude-code-marketplace graphql-guide

For use in Claude.ai and ChatGPT

Download Skill