How this skill is triggered — by the user, by Claude, or both
Slash command
/soda-gql-skills:gql-guideThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
This skill provides interactive guidance on soda-gql features, syntax patterns, and best practices. Parse `$ARGUMENTS` to route to a specific topic, or use AskUserQuestion to let the user choose.
This skill provides interactive guidance on soda-gql features, syntax patterns, and best practices. Parse $ARGUMENTS to route to a specific topic, or use AskUserQuestion to let the user choose.
Parse $ARGUMENTS against the keyword table below. When a topic matches, use the Read tool to load the topic file from ${CLAUDE_PLUGIN_ROOT}/skills/gql-guide/topics/<topic>.md, then present its content to the user.
| Topic | Keywords | Description |
|---|---|---|
| tagged-template | tagged-template, template, syntax | Tagged template syntax for fragments and operations |
| fragment | fragment, spread | Fragment definitions and spreading patterns |
| operation | operation, query, mutation, subscription | Query, mutation, and subscription operations |
| union | union, inline fragment | Union type handling and member selection |
| directive | directive, @include, @skip | GraphQL directives |
| metadata | metadata, callback | Fragment metadata and field-level callbacks |
| setup | setup, install, config | Project setup and initial codegen |
| lsp | lsp, editor, vscode | LSP integration and editor setup |
| codegen | codegen, typegen, build | Schema codegen and build integration |
| colocation | colocation, colocate | Fragment colocation patterns |
If $ARGUMENTS is non-empty, scan the Keywords column for a match (case-insensitive substring).
If exactly one topic matches, read ${CLAUDE_PLUGIN_ROOT}/skills/gql-guide/topics/<topic>.md and present it.
If multiple topics match or $ARGUMENTS is empty/unclear, use AskUserQuestion:
Question: "What would you like guidance on?" Options:
After the user selects a topic, read the corresponding topic file.
If the user's question doesn't match any topic keyword:
docs/guides/ and playgrounds/ for those keywords.Example: User asks "How do I add pagination?"
limit/offset arguments to a field, declare them in the operation variables, pass via $.limit.Before completing this skill, ensure:
npx claudepluginhub whatasoda/soda-gql-skills --plugin soda-gql-skillsGuides writing GraphQL operations (queries, mutations, subscriptions, fragments) with best practices for naming, variables, directives, and data fetching patterns.
Covers GraphQL schema design, resolvers, DataLoader for N+1 prevention, federation, subscriptions, and client integration with Apollo/urql.
Designs GraphQL schemas with type system, SDL patterns, field design, pagination, directives, and versioning for scalable APIs.