Grpc

What it does

When your agent uses it

• : ASP.NET Core gRPC
• Protobuf contracts
• GRPC client factory
• Backend service integration

Example prompts

• “/grpc”

Requirements

• Compatibility (from SKILL.md): Requires ASP.NET Core gRPC or gRPC client projects.

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

1. 1Validate the architecture fit before touching code.
2. 2Treat .proto files as the source of truth.
3. 3Choose the RPC shape from the interaction model.
4. 4Wire server and client behavior together.
5. 5Add observability and resilience where the boundary justifies it.
6. 6Validate with the repo's normal build and tests, plus a focused smoke call when runnable.

What it can do on your machine

Read from SKILL.md and the folder at commit 535dd55. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • dotnet

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

• Compatibility

  Requires ASP.NET Core gRPC or gRPC client projects.

  From compatibility in the SKILL.md frontmatter.

Context cost

Grpc loads about 1.4k tokens when it runs, and up to ~13k if it reads all its reference files. Until then it costs about 109 tokens; SKILL.md has 536 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~109

When it runs · the whole SKILL.md, loaded when a task matches

~1.4k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~13k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from managedcode/dotnet-skills at commit 535dd55, republished under its MIT licence (© managedcode). 536 words, ~1,366 tokens.

name

grpc

description

Build or review gRPC services and clients in .NET. USE FOR: ASP.NET Core gRPC, protobuf contracts, unary or streaming RPC, gRPC client factory, interceptors, deadlines, cancellation, channel reuse, backend service integration. DO NOT USE FOR: broad browser-facing APIs without gRPC-Web tradeoff review, SignalR realtime hubs, plain REST APIs. INVOKES: dotnet build/test and focused service or client smoke checks when code changes.

compatibility

Requires ASP.NET Core gRPC or gRPC client projects.

flowchart LR
  A["RPC requirement"] --> B["proto contract"]
  B --> C["server implementation"]
  B --> D["client factory or channel"]
  C --> E["deadlines / cancellation / status codes"]
  D --> E
  E --> F["build, tests, smoke call"]

builder.Services.AddGrpcClient<Greeter.GreeterClient>(options =>
{
    options.Address = new Uri("https://localhost:5001");
});

var response = await client.SayHelloAsync(
    new HelloRequest { Name = name },
    deadline: DateTime.UtcNow.AddSeconds(5),
    cancellationToken: cancellationToken);

© managedcode, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in catalog/Frameworks/gRPC/skills/grpc of managedcode/dotnet-skills.

• SKILL.md
• manifest.json
• references/anti-patterns.md
• references/patterns.md

Open the folder on GitHubat commit 535dd55