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.