ngql — Stable build of the NGql Skill | dolifer / claude-plugins

ngql — Stable build of the NGql Skill

live · channel: stable · latest published: 1.0.0 ↗

Author NGql query-builder C# in Claude Code — from natural language, paste, or curl. Pairs with the `dotnet-ngql` CLI to verify rendered GraphQL. Stable channel, paired with the released NGql.Core on NuGet.

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:

dotnet add package NGql.Core

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.

Three modes:

Natural language → builder. “Get the top 10 repos of GitHub user dolifer with stargazer counts.” → a QueryBuilder.CreateDefaultBuilder(...) snippet using the fluent API.
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.
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.

Stable vs preview

This is the stable channel — versioned by skill-v<X.Y.Z> tags pushed to dolifer/NGql, released alongside NGql.Core stable releases. SemVer guarantees apply.

The preview channel tracks every push to main and may reference unreleased library APIs. Useful for testing upcoming NGql changes; not recommended for daily work.

Both channels can coexist in the same Claude Code session — /ngql:ngql invokes stable, /ngql-preview:ngql invokes preview. Pick stable for predictable behavior, preview to ride the latest.

Install

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

/plugin install ngql@dolifer

Invoke as:

/ngql:ngql

Update

Pull the latest into your Claude Code session:

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

Companion tool

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

dotnet tool install -g dotnet-ngql

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/.