graphql-schema-generator_skill

Overview

This skill generates complete GraphQL schemas, resolver templates, and type definitions from data models and API requirements. It produces Type, Query, Mutation, input objects, connection/pagination types, and common custom scalars. The output is geared toward practical server implementations and documentation.

How this skill works

Provide your data model or resource descriptions and the skill maps fields to GraphQL types and generates corresponding Query and Mutation definitions. It scaffolds resolver functions with typical data source interactions and authentication checks, and includes pagination, error-handling patterns, and auto-generated documentation. Outputs include schema (SDL) and example resolver code in JavaScript ready for integration.

When to use it

• Designing a new GraphQL API from an existing data model
• Scaffolding server-side resolvers and type definitions quickly
• Standardizing schema patterns like pagination and connections
• Documenting schema contracts for frontend/backend teams
• Adding custom scalars and common input types for mutations

Best practices

• Review and customize generated access control checks to match your auth model
• Keep input types narrow and validate on both schema and service layers
• Use generated connection types for consistent pagination across resources
• Maintain resolver separation: thin resolvers calling well-tested data source methods
• Adjust generated error handling to expose safe, client-friendly messages only

Example use cases

• Generate a User and Post schema with queries, mutations, and connection-based pagination
• Create resolver templates that call existing data sources (REST/DB) with auth stubs
• Produce input types for create/update operations and scaffold validation points
• Auto-generate schema documentation for onboarding frontend developers
• Bootstrap a new service with standard scalars like DateTime and common PageInfo types