Agent skill

Mediator Reference

by fullstackhero in fullstackhero/dotnet-starter-kit

CQRS interface reference for FSH. An agent skill from fullstackhero/dotnet-starter-kit.

MITAuto-check passedBackend & APIs

Install Mediator Reference

skills CLI
$ npx skills add fullstackhero/dotnet-starter-kit --skill mediator-reference -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install fullstackhero/dotnet-starter-kit mediator-reference --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/fullstackhero/dotnet-starter-kit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/mediator-reference .claude/skills/mediator-reference && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
mediator-reference
GitHub stars
6.8k
Token cost
~709 tokens
SKILL.md length
183 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

CQRS interface reference for FSH. An agent skill from fullstackhero/dotnet-starter-kit.

  • Tasks that involve Event-driven systems
  • SKILL.md covers Interfaces, Pattern, Registration — the four places and Common errors
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Tasks that involve Project scaffolding

What it does

Mediator Reference is an agent skill from fullstackhero/dotnet-starter-kit. CQRS interface reference for FSH. This project uses the Mediator source generator, NOT MediatR. Reference when implementing commands, queries, and handlers.

Its SKILL.md is about 710 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering Event-driven systems and Project scaffolding. The repository describes itself as: Production Grade Cloud-Ready .NET 10 Starter Kit (Web API + React Client) with Multitenancy Support, and Clean/Modular Architecture that saves roughly 200+ Development Hours! All… The licence is MIT.

When your agent uses it

  • Tasks that involve Event-driven systems
  • Tasks that involve Project scaffolding

Example prompts

  • “/mediator-reference”

What it can do on your machine

Read from SKILL.md and the folder at commit 0bd98e3. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are csharp).

    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.

Context cost

Mediator Reference loads about 709 tokens when it runs. Until then it costs about 44 tokens; SKILL.md has 183 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~44
When it runs · the whole SKILL.md, loaded when a task matches
~709

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

Auto-check passed

The automated check found no risky patterns in SKILL.md.

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 fullstackhero/dotnet-starter-kit at commit 0bd98e3, republished under its MIT licence (© fullstackhero). 183 words, ~709 tokens.

Download SKILL.mdSave it as .claude/skills/mediator-reference/SKILL.md (or your agent's skills folder).
name
mediator-reference
description
CQRS interface reference for FSH. This project uses the Mediator source generator, NOT MediatR. Reference when implementing commands, queries, and handlers.
user-invocable
false

Mediator Reference

⚠️ FSH uses the Mediator source-generator package (using Mediator;), NOT MediatR. Different interfaces — MediatR types won't compile. The CQRS interfaces below are the library's own (no FSH wrapper).

Interfaces

Purpose✅ Mediator (use)❌ MediatR (don't)
CommandICommand<TResponse>IRequest<TResponse>
QueryIQuery<TResponse>IRequest<TResponse>
Command handlerICommandHandler<TCommand, TResponse>IRequestHandler<…>
Query handlerIQueryHandler<TQuery, TResponse>IRequestHandler<…>
Notification / domain eventINotification (IDomainEvent : INotification)INotification

Pattern

csharp
// Command/Query → the Contracts project (Modules.{X}.Contracts/v1/{Area}/)
public sealed record Create{Entity}Command(string Name) : ICommand<Guid>;

// Handler → the runtime project (Modules.{X}/Features/v1/{Area}/{Feature}/), public sealed
public sealed class Create{Entity}CommandHandler({X}DbContext db)
    : ICommandHandler<Create{Entity}Command, Guid>
{
    public async ValueTask<Guid> Handle(Create{Entity}Command command, CancellationToken cancellationToken)
    {
        // …
    }
}

Rules: handlers return ValueTask<T> (not Task<T>); parameter named command/query (not request); public sealed; .ConfigureAwait(false) on awaits. Send via mediator.Send(command, ct) (the IMediator interface name matches MediatR's — that part is fine).

Registration — the four places

The source generator only scans assemblies listed in o.Assemblies, and that list exists in two host files. A new module needs two markers (a Contracts type and the module type) added to the Mediator list plus an entry in the moduleAssemblies array — in both FSH.Starter.Api/Program.cs and FSH.Starter.DbMigrator/Program.cs:

csharp
builder.Services.AddMediator(o =>
{
    o.ServiceLifetime = ServiceLifetime.Scoped;
    o.Assemblies = [
        /* … */
        typeof(FSH.Modules.{X}.Contracts.{X}ContractsMarker),   // Contracts assembly
        typeof(FSH.Modules.{X}.{X}Module)];                     // runtime assembly
});

See add-module for the full procedure.

Common errors

SymptomCause → fix
IRequest<T> / IRequestHandler<,> not foundMediatR interface → use ICommand/IQuery + ICommandHandler/IQueryHandler
Task<T> vs ValueTask<T> mismatchHandler must return ValueTask<T>
Handler not invoked at runtimeAssembly missing from o.Assemblies (in one or both Program.cs files)

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

Files

Just SKILL.md in .agents/skills/mediator-reference of fullstackhero/dotnet-starter-kit.

Open the folder on GitHubat commit 0bd98e3

Compare with similar skills

Mediator Reference next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Mediator Reference compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Mediator Reference this skillfullstackhero/dotnet-starter-kit6.8k—~709Automated safety check: PassMIT
Adobe App Builder Action Scaffolderadobe/skills195—~3.1kAutomated safety check: PassApache-2.0
Rtvi Cv Scaffold Vss ServiceNVIDIA/skills3.5k—~4.5kAutomated safety check: PassProprietary
Scaffolding Fastapi Dapraiskillstore/marketplace430—~2.2kAutomated safety check: PassNone
Inngest Nextjs Patternspproenca/dot-skills214—~1.4kAutomated safety check: NotesMIT
Flowfile Frame And CodegenEdwardvaneechoud/Flowfile370—~12kAutomated safety check: PassMIT

Similar skills

  • Scaffolds, implements, deploys and debugs Adobe Runtime actions in App Builder projects, with templates for webhooks, events, database CRUD, sequences and Asset Compute workers.

    195 GitHub stars~3.1k tokensUpdated today
    Backend & APIsAuto-check passed
  • Official

    Scaffold a standalone RTVI CV microservice that plugs into VSS Search and Alerts profiles via Kafka mdx-raw.

    3.5k GitHub stars~4.5k tokensUpdated today
    Backend & APIsAuto-check passed
  • Scaffolding Fastapi Dapr

    aiskillstore/marketplace

    Build production-grade FastAPI backends with SQLModel, Dapr integration, and JWT authentication.

    430 GitHub stars~2.2k tokensUpdated today
    Backend & APIsAuto-check passed
  • Inngest Nextjs Patterns

    pproenca/dot-skills

    Inngest event-driven functions in a Next.js (App Router) project — creating the client, the /api/inngest route handler, typed events with Zod schemas, durable event-triggered functions, scheduled…

    214 GitHub stars~1.4k tokensUpdated 1 mo ago
    Backend & APIsAuto-check: notes
  • Flowfile Frame And Codegen

    Edwardvaneechoud/Flowfile

    Deep dive into flowfileframe — the Polars-LazyFrame-shaped Python API that builds an in-process flowfilecore FlowGraph as a side effect of every method call — covering the FlowFrame/Expr internals…

    370 GitHub stars~12k tokensUpdated yesterday
    Data & AnalyticsAuto-check passed
  • Dotnet Clean Architecture

    fmflurry/settings-opencode

    Scaffolds and extends .NET 10 Minimal API modules using self-registering IModule + IEndpoint (reflection discovery) + hexagonal ports/adapters per module…

    171 GitHub stars~5.5k tokensUpdated 2 days ago
    DevelopmentAuto-check passed

More from fullstackhero/dotnet-starter-kit

All 11 skills in this repo
  • Add Entity

    fullstackhero/dotnet-starter-kit

    Add a domain entity/aggregate with EF configuration and a migration to an existing FSH module.

    6.8k GitHub stars~1.2k tokensUpdated 7 days ago
    Auto-check passed
  • Add Feature

    fullstackhero/dotnet-starter-kit

    Add a vertical-slice feature (command/query + handler + validator + endpoint) to an existing FSH module.

    6.8k GitHub stars~1.1k tokensUpdated 7 days ago
    Auto-check passed
  • Add Full Slice

    fullstackhero/dotnet-starter-kit

    Build a capability end-to-end — backend vertical slice (Contracts→handler→validator→endpoint) AND the React page wired to it.

    6.8k GitHub stars~783 tokensUpdated 7 days ago
    Auto-check passed
  • Add Integration Event

    fullstackhero/dotnet-starter-kit

    Publish a cross-module integration event via the Outbox and handle it idempotently in another module.

    6.8k GitHub stars~1.1k tokensUpdated 7 days ago
    Auto-check passed
  • Add Module

    fullstackhero/dotnet-starter-kit

    Create a new module (bounded context) — runtime + Contracts projects, IModule, DbContext, permissions, migrations, and the four registration sites.

    6.8k GitHub stars~1.5k tokensUpdated 7 days ago
    Auto-check passed
  • Add Permission

    fullstackhero/dotnet-starter-kit

    Add a new permission end-to-end — server constant + endpoint gate, and (admin app) mirror it into the permissions catalog + route guard.

    6.8k GitHub stars~849 tokensUpdated 7 days ago
    Auto-check passed

Questions about Mediator Reference

What does Mediator Reference do?

CQRS interface reference for FSH. An agent skill from fullstackhero/dotnet-starter-kit. Mediator Reference is an agent skill from fullstackhero/dotnet-starter-kit. CQRS interface reference for FSH.

When should I use Mediator Reference?

Mediator Reference fits situations like: tasks that involve Event-driven systems; tasks that involve Project scaffolding.

How do I install Mediator Reference in Claude Code?

Run `npx skills add fullstackhero/dotnet-starter-kit --skill mediator-reference -a claude-code`. Or copy the skill folder (.agents/skills/mediator-reference in fullstackhero/dotnet-starter-kit) into .claude/skills/mediator-reference in your project. Claude Code loads it when a task matches its description.

How do I install Mediator Reference in Codex?

Run `npx skills add fullstackhero/dotnet-starter-kit --skill mediator-reference -a codex`. Or copy the skill folder (.agents/skills/mediator-reference in fullstackhero/dotnet-starter-kit) into .agents/skills/mediator-reference in your project. Codex loads it when a task matches its description.

Can I use Mediator Reference in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add fullstackhero/dotnet-starter-kit --skill mediator-reference -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mediator-reference, .gemini/skills/mediator-reference, .github/skills/mediator-reference and .opencode/skills/mediator-reference in your project.

What does Mediator Reference need to run?

SKILL.md names no scripts, command-line tools or credentials: Mediator Reference is instructions for the agent only.

Does Mediator Reference access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Mediator Reference safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Mediator Reference use?

Mediator Reference is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Mediator Reference use?

About 709 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Mediator Reference?

Skills that share tags, products or a category with Mediator Reference: Adobe App Builder Action Scaffolder (adobe/skills, 195 stars), Rtvi Cv Scaffold Vss Service (NVIDIA/skills, 3.5k stars), Scaffolding Fastapi Dapr (aiskillstore/marketplace, 430 stars) and Inngest Nextjs Patterns (pproenca/dot-skills, 214 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mediator Reference?

fullstackhero (a GitHub organization) maintains it in fullstackhero/dotnet-starter-kit, which has 6,813 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on September 30, 2026.

Source: fullstackhero/dotnet-starter-kit on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.