Back to Skills

graphql

KubrickCode
Updated Today
90 views
1
1
View on GitHub
Metaapidesigndata

About

This Claude Skill provides expert GraphQL API design and implementation guidance. It specializes in schema-first design, resolver implementation, DataLoader for N+1 prevention, and federation architecture while following Apollo and Relay best practices. Use it when designing schemas, implementing queries/mutations, setting up pagination, handling errors, or working with GraphQL libraries.

Documentation

GraphQL API Standards

Naming Conventions

Field Naming

  • Boolean: Require is/has/can prefix
  • Date: Require ~At suffix
  • Use consistent terminology throughout the project (unify on either "create" or "add")

Date Format

  • ISO 8601 UTC
  • Use DateTime type

Pagination

Relay Connection Specification

type UserConnection {
  edges: [UserEdge!]!
  pageInfo: PageInfo!
}

type UserEdge {
  node: User!
  cursor: String!
}

type PageInfo {
  hasNextPage: Boolean!
  endCursor: String
}
  • Parameters: first, after

Sorting

  • orderBy: [{ field: "createdAt", order: DESC }]

Type Naming

  • Input: {Verb}{Type}Input
  • Connection: {Type}Connection
  • Edge: {Type}Edge

Input

  • Separate creation and modification (required for creation, optional for modification)
  • Avoid nesting - IDs only

Errors

extensions (default)

  • code, field in errors[].extensions

Union (type safety)

  • User | ValidationError

N+1

  • DataLoader is mandatory

Documentation

  • """description""" is required
  • Explicitly state Input constraints

Deprecation

  • @deprecated(reason: "...")
  • Never delete types

Quick Install

/plugin add https://github.com/KubrickCode/ai-config-toolkit/tree/main/graphql

Copy and paste this command in Claude Code to install this skill

GitHub 仓库

KubrickCode/ai-config-toolkit
Path: .claude/skills/graphql

Related Skills

evaluating-llms-harness

Testing

This Claude Skill runs the lm-evaluation-harness to benchmark LLMs across 60+ standardized academic tasks like MMLU and GSM8K. It's designed for developers to compare model quality, track training progress, or report academic results. The tool supports various backends including HuggingFace and vLLM models.

View skill

langchain

Meta

LangChain is a framework for building LLM applications using agents, chains, and RAG pipelines. It supports multiple LLM providers, offers 500+ integrations, and includes features like tool calling and memory management. Use it for rapid prototyping and deploying production systems like chatbots, autonomous agents, and question-answering services.

View skill

webapp-testing

Testing

This Claude Skill provides a Playwright-based toolkit for testing local web applications through Python scripts. It enables frontend verification, UI debugging, screenshot capture, and log viewing while managing server lifecycles. Use it for browser automation tasks but run scripts directly rather than reading their source code to avoid context pollution.

View skill

business-rule-documentation

Meta

This skill provides standardized templates for systematically documenting business logic and domain knowledge following Domain-Driven Design principles. It helps developers capture business rules, process flows, decision trees, and terminology glossaries to maintain consistency between requirements and implementation. Use it when documenting domain models, creating business rule repositories, or bridging communication between business and technical teams.

View skill