Agent skill

Mud Quickstart

by Nethereum in Nethereum/Nethereum

Help users build MUD applications with Nethereum — define tables, generate C code, interact with World contracts, use the namespace pattern.

MITAuto-check passedBackend & APIs

Install Mud Quickstart

skills CLI
$ npx skills add Nethereum/Nethereum --skill mud-quickstart -a claude-code

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

GitHub CLI
$ gh skill install Nethereum/Nethereum mud-quickstart --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/Nethereum/Nethereum.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/nethereum-skills/skills/mud-quickstart .claude/skills/mud-quickstart && 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
mud-quickstart
GitHub stars
2.3k
Token cost
~952 tokens
SKILL.md length
228 words
Files
1
Skills in repo
71
Repo updated
First seen
Licence
MIT

At a glance

Help users build MUD applications with Nethereum — define tables, generate C code, interact with World contracts, use the namespace pattern.

  • Works in 4 steps: Define tables in mud.config.ts using… → Compile contracts with Forge → Create .nethereum-gen.multisettings → …
  • Users mention MUD
  • SKILL.md covers When to Use This Skill, Required Packages, Code Generation Workflow and Using Generated Services, plus 2 more sections
  • Calls dotnet

What it does

Mud Quickstart is an agent skill from Nethereum/Nethereum. Help users build MUD applications with Nethereum — define tables, generate C code, interact with World contracts, use the namespace pattern. Use when users mention MUD, autonomous worlds, on-chain structured data, MUD tables, MUD systems, defineWorld, World contract, or any MUD-related development with C or .NET.

Its SKILL.md is about 950 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 Smart contracts and Schema markup. It works with C# and .NET. The repository describes itself as: Ethereum .Net cross platform integration library. The licence is MIT.

When your agent uses it

  • Users mention MUD
  • Autonomous worlds
  • On-chain structured data
  • Any MUD-related development with C

Example prompts

  • “/mud-quickstart”

Workflow steps

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

  1. Define tables in mud.config.ts using defineWorld() at mud.dev
  2. Compile contracts with Forge
  3. Create .nethereum-gen.multisettings
  4. Run: Nethereum.Generator.Console generate from-config

What it can do on your machine

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

    Links to these hosts (documentation or services it may open):

    • mud.dev
    • github.com
    • docs.nethereum.com

    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

Mud Quickstart loads about 952 tokens when it runs. Until then it costs about 83 tokens; SKILL.md has 228 words of instructions outside code blocks.

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

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 Nethereum/Nethereum at commit 229f278, republished under its MIT licence (© Nethereum). 228 words, ~952 tokens.

Download SKILL.mdSave it as .claude/skills/mud-quickstart/SKILL.md (or your agent's skills folder).
name
mud-quickstart
description
Help users build MUD applications with Nethereum — define tables, generate C# code, interact with World contracts, use the namespace pattern. Use when users mention MUD, autonomous worlds, on-chain structured data, MUD tables, MUD systems, defineWorld, World contract, or any MUD-related development with C# or .NET.
user-invocable
true

MUD Quickstart with Nethereum

MUD is an enhanced EIP-2535 Diamond pattern for building complex smart contract applications. A World contract acts as a diamond proxy — routing calls to system contracts via delegatecall, with all state stored in typed tables. Namespaces group systems and tables into a unified context (like web3.Eth). It's not just for games — any application with complex structured on-chain state benefits.

When to Use This Skill

  • User wants to build a MUD application with .NET/C#
  • User needs to generate C# code from MUD table definitions
  • User is working with MUD World contracts, tables, or systems
  • User mentions defineWorld, mud.config.ts, or MUD namespaces

Required Packages

bash
dotnet add package Nethereum.Mud
dotnet add package Nethereum.Mud.Contracts

For code generation CLI:

bash
dotnet tool install -g Nethereum.Generator.Console

Code Generation Workflow

  1. Define tables in mud.config.ts using defineWorld() at mud.dev
  2. Compile contracts with Forge
  3. Create .nethereum-gen.multisettings:
json
[
  {
    "paths": ["path/to/mud.config.ts"],
    "generatorConfigs": [
      {
        "baseNamespace": "MyProject.Contracts",
        "basePath": "Generated/Tables",
        "codeGenLang": 0,
        "generatorType": "MudTables"
      }
    ]
  }
]
  1. Run: Nethereum.Generator.Console generate from-config

Generator types:

  • MudTables — generates TableRecord and TableService from mud.config.ts
  • MudExtendedService — generates system service wrappers from compiled JSON
  • ContractDefinition — standard ABI-to-C# (non-MUD contracts)

Using Generated Services

csharp
var playerService = new PlayerTableService(web3, worldAddress);

// Read
var player = await playerService.GetTableRecordAsync(
    new PlayerTableRecord.PlayerKey { Address = addr });

// Write
await playerService.SetRecordRequestAndWaitForReceiptAsync(
    new PlayerTableRecord.PlayerKey { Address = addr },
    new PlayerTableRecord.PlayerValue { Score = 100, Name = "Alice" });

// Delete
await playerService.DeleteRecordRequestAndWaitForReceiptAsync(
    new PlayerTableRecord.PlayerKey { Address = addr });

Namespace Pattern (Production)

Aggregate generated services into namespace classes:

csharp
public class AppNamespace : NamespaceBase<AppResource, AppSystems, AppTables>
{
    public AppNamespace(IWeb3 web3, string contractAddress) : base(web3, contractAddress)
    {
        Systems = new AppSystems(web3, contractAddress);
        Tables = new AppTables(web3, contractAddress);
    }
}

// Usage
var app = new AppNamespace(web3, worldAddress);
var player = await app.Tables.Player.GetTableRecordAsync(key);

See CafeCosmos for a production example with 35+ tables.

Key Classes

ClassPurpose
TableRecord<TKey, TValue>Base for keyed table records
TableRecordSingleton<TValue>Base for singleton table records (key: [])
TableService<TRecord, TKey, TValue>Typed CRUD for keyed tables
TableSingletonService<TRecord, TValue>Typed CRUD for singleton tables
ResourceEncoderEncode table/system/namespace resource IDs
NamespaceBase<TResource, TSystems, TTables>Base for namespace aggregation

For full documentation, see: https://docs.nethereum.com/docs/mud-framework/guide-mud-quickstart

© Nethereum, 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 plugins/nethereum-skills/skills/mud-quickstart of Nethereum/Nethereum.

Open the folder on GitHubat commit 229f278

Compare with similar skills

Mud Quickstart 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.

Mud Quickstart compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Mud Quickstart this skillNethereum/Nethereum2.3k—~952Automated safety check: PassMIT
.NET API Compatibility DesignAaronontheweb/dotnet-skills1.2k2 repos~2.7kAutomated safety check: PassMIT
Tsp Csharpquerylenshq/ef-querylens225—~1.3kAutomated safety check: PassMIT
XML DocumentationVonage/vonage-dotnet-sdk118—~2.7kAutomated safety check: PassApache-2.0
Dotnet 10 Csharp 14sketch7/FluentlyHttpClient121—~2.2kAutomated safety check: PassMIT
DisCatSharp Discord DevelopmentAiko-IT-Systems/DisCatSharp140—~1.2kAutomated safety check: PassMIT

Similar skills

  • .NET API Compatibility Design

    Aaronontheweb/dotnet-skills

    Applies extend-only design rules to NuGet packages and distributed systems, covering source, binary and wire compatibility and how to deprecate members safely.

    1.2k GitHub starsUsed in 2 repos~2.7k tokens
    Backend & APIsAuto-check passed
  • Tsp Csharp

    querylenshq/ef-querylens

    Comprehensive C and .NET development skill for TSP projects.

    225 GitHub stars~1.3k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • XML Documentation

    Vonage/vonage-dotnet-sdk

    Improve XML documentation in the Vonage .NET SDK. An agent skill from Vonage/vonage-dotnet-sdk.

    118 GitHub stars~2.7k tokensUpdated 3 mo ago
    Backend & APIsAuto-check passed
  • Dotnet 10 Csharp 14

    sketch7/FluentlyHttpClient

    A skill your agent uses when building .NET 10 or C 14 applications; when using minimal APIs, modular monolith patterns, or feature folders; when implementing HTTP resilience, Options pattern…

    121 GitHub stars~2.2k tokensUpdated 19 days ago
    Backend & APIsAuto-check passed
  • DisCatSharp Discord Development

    Aiko-IT-Systems/DisCatSharp

    Helps build, explain and troubleshoot C# Discord apps on DisCatSharp, answering from the project's installed version and the library's documentation rather than guesses.

    140 GitHub stars~1.2k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Foundationdb Advanced Layers

    SnowBankSDK/foundationdb-dotnet-client

    Advanced engineering for sophisticated FoundationDB layers with the .NET client (FoundationDB.Client / SnowBank) — the cluster model and transaction lifecycle (proxies, resolvers, tlogs, storage…

    158 GitHub stars~3.4k tokensUpdated 6 days ago
    Backend & APIsAuto-check passed

More from Nethereum/Nethereum

All 71 skills in this repo
  • Aa Batching Paymasters

    Nethereum/Nethereum

    Help users batch multiple calls into a single UserOperation and sponsor gas with paymasters using Nethereum Account Abstraction.

    2.3k GitHub stars~1.5k tokensUpdated 2 days ago
    Auto-check passed
  • Aa Bundler

    Nethereum/Nethereum

    Help users run an ERC-4337 bundler using Nethereum — set up in-process or standalone bundlers with mempool, validation, reputation, and JSON-RPC server.

    2.3k GitHub stars~1.2k tokensUpdated 2 days ago
    Auto-check passed
  • Abi Encoding

    Nethereum/Nethereum

    Encode and decode Ethereum ABI data with Nethereum. An agent skill from Nethereum/Nethereum.

    2.3k GitHub stars~1.3k tokensUpdated 2 days ago
    Auto-check passed
  • Abi Retrieval

    Nethereum/Nethereum

    Fetch contract ABIs from Sourcify, Etherscan, and 4Byte Directory using the composite ABIInfoStorage pattern (.NET/C).

    2.3k GitHub stars~1.5k tokensUpdated 2 days ago
    Auto-check passed
  • Account Abstraction

    Nethereum/Nethereum

    Help users implement ERC-4337 Account Abstraction with Nethereum — send UserOperations, use smart accounts, route contract calls through a bundler, enable gasless transactions, or work with AA in…

    2.3k GitHub stars~1.7k tokensUpdated 2 days ago
    Auto-check passed
  • Address Utils

    Nethereum/Nethereum

    Validate and format Ethereum addresses with Nethereum. An agent skill from Nethereum/Nethereum.

    2.3k GitHub stars~1.2k tokensUpdated 2 days ago
    Auto-check passed

Works with

Questions about Mud Quickstart

What does Mud Quickstart do?

Help users build MUD applications with Nethereum — define tables, generate C code, interact with World contracts, use the namespace pattern. Mud Quickstart is an agent skill from Nethereum/Nethereum. Help users build MUD applications with Nethereum — define tables, generate C code, interact with World contracts, use the namespace pattern.

When should I use Mud Quickstart?

Mud Quickstart fits situations like: users mention MUD; autonomous worlds; on-chain structured data; any MUD-related development with C.

How do I install Mud Quickstart in Claude Code?

Run `npx skills add Nethereum/Nethereum --skill mud-quickstart -a claude-code`. Or copy the skill folder (plugins/nethereum-skills/skills/mud-quickstart in Nethereum/Nethereum) into .claude/skills/mud-quickstart in your project. Claude Code loads it when a task matches its description.

How do I install Mud Quickstart in Codex?

Run `npx skills add Nethereum/Nethereum --skill mud-quickstart -a codex`. Or copy the skill folder (plugins/nethereum-skills/skills/mud-quickstart in Nethereum/Nethereum) into .agents/skills/mud-quickstart in your project. Codex loads it when a task matches its description.

Can I use Mud Quickstart 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 Nethereum/Nethereum --skill mud-quickstart -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mud-quickstart, .gemini/skills/mud-quickstart, .github/skills/mud-quickstart and .opencode/skills/mud-quickstart in your project.

What does Mud Quickstart need to run?

Going by SKILL.md and its folder, Mud Quickstart needs the command-line tools its instructions call (dotnet).

Does Mud Quickstart access the network?

SKILL.md names 3 domains. As links in the text: mud.dev, github.com and docs.nethereum.com. This is read from the text; nothing was executed.

Is Mud Quickstart 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 Mud Quickstart use?

Mud Quickstart 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 Mud Quickstart use?

About 952 tokens (SKILL.md is roughly 3.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 Mud Quickstart?

Skills that share tags, products or a category with Mud Quickstart: .NET API Compatibility Design (Aaronontheweb/dotnet-skills, 1.2k stars), Tsp Csharp (querylenshq/ef-querylens, 225 stars), XML Documentation (Vonage/vonage-dotnet-sdk, 118 stars) and Dotnet 10 Csharp 14 (sketch7/FluentlyHttpClient, 121 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mud Quickstart?

Nethereum (a GitHub organization) maintains it in Nethereum/Nethereum, which has 2,260 GitHub stars. The repository holds 71 skills in this directory. The repository was last updated on October 5, 2026.

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