gql:scaffold

Generate type-safe GraphQL fragments and operations from a schema.

1|1|Updated Sep 6, 2025
One-click install
npx skills add https://github.com/whatasoda/soda-gql --skill gql-scaffold
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gql:scaffold
Source: https://github.com/whatasoda/soda-gql/tree/main/claude-code-plugin/skills/gql-scaffold
Command: npx skills add https://github.com/whatasoda/soda-gql --skill gql-scaffold

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generate reusable, type-safe GraphQL fragments and operations from a schema to reduce boilerplate and improve correctness across clients.

Core Features & Use Cases

  • Generate type-safe fragments and operations from schema introspection.
  • Automatically select between tagged template and callback builder syntax based on features like aliases, fragment spreads, and metadata.
  • Validate generated code with the project typegen and typecheck steps, and support editing through fragments and operations files.

Quick Start

Provide a Soda-GQL project configuration and schema, then initiate the scaffold to generate the code.

Frequently Asked Questions about gql:scaffold

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate type-safe GraphQL fragments and operations from a schema?

To generate type-safe GraphQL fragments and operations, provide a Soda-GQL project configuration and schema access to initiate the scaffold and automatically produce validated code.

Does GraphQL code generation automatically choose between tagged template and callback builder syntax?

Yes, GraphQL code generation automatically selects between tagged template and callback builder syntax based on feature requirements like aliases, fragment spreads, and metadata.

What do I need to configure before scaffolding GraphQL operations?

Before scaffolding GraphQL operations, you need proper Soda-GQL configuration and schema access to enable code generation and validation through project typegen and typecheck steps.

How do I validate generated GraphQL fragments and operations?

You validate generated GraphQL fragments and operations by running the project typegen and typecheck steps, ensuring correctness across clients after the scaffold process completes.

When should I use a scaffold to generate GraphQL operations instead of writing them manually?

Use a scaffold to generate GraphQL operations when you need to reduce boilerplate and improve correctness across clients by producing reusable, type-safe fragments from schema introspection.