← back to all skills

ngql-preview — Preview build of the NGql Skill

live  ·  channel: preview  ·  latest published: 1.0.1-preview.38 ↗

Author NGql query-builder C# in Claude Code — from natural language, paste, or curl. Pairs with the `dotnet-ngql` CLI to verify rendered GraphQL. Preview channel, tracks every push to `main` and may reference unreleased library APIs.

What is NGql?

NGql is a zero-dependency, schema-less GraphQL query builder for .NET. Compose queries and mutations from C# with a fluent API — no SDL, no codegen, no schema validation step. Multi-targets net8.0 / net9.0 / net10.0.

The library is fully usable on its own. To track the preview channel matching this Skill, pin a preview version:

dotnet add package NGql.Core --version 2.1.1-preview.X

Or skip --version to get the latest stable.

Library docs: dolifer.github.io/NGql/ · Source: github.com/dolifer/NGql

What this Skill is for

This Skill is a productivity layer on top of the library. It teaches Claude Code to translate your intent — natural language, pasted GraphQL, or a curl command — into NGql query-builder C# code, and (when explicitly asked) to verify the rendered GraphQL via the dotnet-ngql CLI before you commit. Use it when you want Claude to author NGql code; skip it when you’d rather write the C# yourself.

The preview channel may reference library APIs that haven’t shipped to stable yet — useful for testing upcoming NGql changes or comparing behavior against stable side-by-side.

Three modes:

  1. Natural language → builder. “Get the top 10 repos of GitHub user dolifer with stargazer counts.” → a QueryBuilder.CreateDefaultBuilder(...) snippet using the fluent API.
  2. GraphQL or curl → builder. Paste an operation or curl command, the Skill rewrites it as NGql calls — preserving operation name, variable types, enum literals, nested arguments, and inline fragments via OnType.
  3. Refactor / preserve. “Strip ssn and email from this builder.” → a PreservationBuilder.Preserve(...) chain that keeps everything else.

The Skill is prescriptive — it picks one safe API idiom per situation and refuses to generate code for unsupported GraphQL constructs (named fragments, directives, subscriptions). When the request needs something NGql can’t model, the Skill stops, surfaces the gap, and offers concrete workaround paths instead of producing broken code with a warning.

Pairs with the dotnet-ngql CLI to verify rendered GraphQL — the Skill produces the snippet and command line, and (when explicitly asked) runs the tool for you, surfacing the rendered GraphQL and any execution result.

Switching to stable

The stable ngql channel is also live — both can coexist in the same Claude Code session. Invoke as /ngql:ngql (stable) vs /ngql-preview:ngql (preview). Preview is allowed to break and iterate; stable carries SemVer guarantees and ships only on skill-v<X.Y.Z> tags.

Install

Ensure the marketplace is registered (one-time setup), then run:

/plugin install ngql-preview@dolifer

Invoke as:

/ngql-preview:ngql

Update

Pull the latest into your Claude Code session:

/plugin marketplace update
/plugin update ngql-preview@dolifer
/reload-plugins

Companion tool

This Skill pairs with the dotnet-ngql CLI for verifying generated snippets:

dotnet tool install -g dotnet-ngql --prerelease

Report issues

Found a bug, a wrong example, or a hallucinated method? File at dolifer/NGql/issues with the skill label. The Skill content is generated from its source repo, so a fix lands in this catalog automatically on the next release.

Skill source-of-truth lives in dolifer/NGql:.claude/skills/ngql-local. Marketplace catalog content for this skill: plugins/ngql-preview/.