Agent skill

Circles

Interact with the Circles UBI protocol using Nethereum (.NET/C).

Install Circles

skills CLI

$ npx skills add Nethereum/Nethereum --skill circles -a claude-code

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

GitHub CLI

$ gh skill install Nethereum/Nethereum circles --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/circles .claude/skills/circles && 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/

Paste into Claude Code

Install the "circles" agent skill from https://github.com/Nethereum/Nethereum/tree/master/plugins/nethereum-skills/skills/circles into .claude/skills/circles/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "circles", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/Nethereum/Nethereum/tree/master/plugins/nethereum-skills/skills/circles

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add Nethereum/Nethereum --skill circles -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install Nethereum/Nethereum circles --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Nethereum/Nethereum.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/nethereum-skills/skills/circles .agents/skills/circles && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "circles" agent skill from https://github.com/Nethereum/Nethereum/tree/master/plugins/nethereum-skills/skills/circles into .agents/skills/circles/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "circles", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add Nethereum/Nethereum --skill circles -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install Nethereum/Nethereum circles --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Nethereum/Nethereum.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/nethereum-skills/skills/circles .cursor/skills/circles && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "circles" agent skill from https://github.com/Nethereum/Nethereum/tree/master/plugins/nethereum-skills/skills/circles into .cursor/skills/circles/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "circles", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/Nethereum/Nethereum.git --path plugins/nethereum-skills/skills/circles

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add Nethereum/Nethereum --skill circles -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install Nethereum/Nethereum circles --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Nethereum/Nethereum.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/nethereum-skills/skills/circles .gemini/skills/circles && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "circles" agent skill from https://github.com/Nethereum/Nethereum/tree/master/plugins/nethereum-skills/skills/circles into .gemini/skills/circles/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "circles", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install Nethereum/Nethereum circles

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add Nethereum/Nethereum --skill circles -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/Nethereum/Nethereum.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/nethereum-skills/skills/circles .github/skills/circles && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "circles" agent skill from https://github.com/Nethereum/Nethereum/tree/master/plugins/nethereum-skills/skills/circles into .github/skills/circles/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "circles", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add Nethereum/Nethereum --skill circles -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install Nethereum/Nethereum circles --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Nethereum/Nethereum.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/nethereum-skills/skills/circles .opencode/skills/circles && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "circles" agent skill from https://github.com/Nethereum/Nethereum/tree/master/plugins/nethereum-skills/skills/circles into .opencode/skills/circles/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "circles", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: circles
GitHub stars: 2.3k
Token cost: ~1k tokens
SKILL.md length: 257 words
Files: 1
Skills in repo: 71
Repo updated: Oct 5, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Interact with the Circles UBI protocol using Nethereum (.NET/C).

The user asks about Circles protocol
SKILL.md covers Query Balances, Hub Contract Interaction, Mint Personal CRC and Transaction History, plus 4 more sections
Calls dotnet; reaches rpc.aboutcircles.com and chiado-rpc.aboutcircles.com
Universal Basic Income

What it does

Circles is an agent skill from Nethereum/Nethereum. Interact with the Circles UBI protocol using Nethereum (.NET/C). Use this skill whenever the user asks about Circles protocol, Universal Basic Income, CRC tokens, Circles balances, trust relationships, personal minting, demurrage tokens, or any Circles UBI interaction on Gnosis Chain with C or .NET.

Its SKILL.md is about 1k 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. 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

The user asks about Circles protocol
Universal Basic Income
Circles balances
Trust relationships

Example prompts

“/circles”

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
Hosts in commands or code, which the agent is likely to contact:
- rpc.aboutcircles.com
- chiado-rpc.aboutcircles.com
Also links to:
- aboutcircles.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

Circles loads about 1k tokens when it runs. Until then it costs about 78 tokens; SKILL.md has 257 words of instructions outside code blocks.

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

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). 257 words, ~1,023 tokens.

Download SKILL.mdSave it as .claude/skills/circles/SKILL.md (or your agent's skills folder).

name: circles
description: Interact with the Circles UBI protocol using Nethereum (.NET/C#). Use this skill whenever the user asks about Circles protocol, Universal Basic Income, CRC tokens, Circles balances, trust relationships, personal minting, demurrage tokens, or any Circles UBI interaction on Gnosis Chain with C# or .NET.
user-invocable: true

Circles: UBI Protocol

Circles is a decentralized Universal Basic Income protocol on Gnosis Chain. Every registered avatar receives 1 CRC per hour, with ~7% annual demurrage. Tokens transfer through trust networks — you can only send CRC to someone who trusts you. Nethereum's Nethereum.Circles package provides contract services for on-chain operations and custom RPC methods for data queries.

NuGet: Nethereum.Circles

bash

dotnet add package Nethereum.Circles

Query Balances

The Circles RPC endpoint exposes custom methods. The simplest balance check:

csharp

var client = new RpcClient(new Uri("https://rpc.aboutcircles.com/"));
var getTotalBalance = new GetTotalBalanceV2(client);
string balance = await getTotalBalance.SendRequestAsync("0xAvatarAddress");

This returns the total balance across all Circles token types — personal CRC plus any group currencies.

Hub Contract Interaction

The Hub is the central contract for avatar registration, trust, and minting:

csharp

var hubService = new HubService(web3, "0xc12C1E50ABB450d6205Ea2C3Fa861b3B834d13e8");

bool isHuman = await hubService.IsHumanQueryAsync("0xAddress");
bool isTrusted = await hubService.IsTrustedQueryAsync("0xTruster", "0xTrustee");
var issuance = await hubService.CalculateIssuanceQueryAsync("0xHumanAddress");

These are read-only calls — no gas needed.

Mint Personal CRC

Circles avatars typically use Gnosis Safe wallets. Mint through Safe execution using the ChangeContractHandlerToSafeExecTransaction extension from Nethereum.GnosisSafe:

csharp

var hubService = new HubService(web3, hubAddress);
hubService.ChangeContractHandlerToSafeExecTransaction(safeAddress, privateKey);
await hubService.PersonalMintRequestAndWaitForReceiptAsync();

The Safe is the registered avatar, not the EOA. The extension method wraps the mint call in a Safe execTransaction.

Transaction History

Paginated transaction history through the Circles RPC:

csharp

var historyQuery = new GetTransactionHistoryQuery(client);
var transactions = await historyQuery.SendRequestAsync("0xAvatarAddress", 100);

foreach (var tx in transactions.Response)
    Console.WriteLine($"{tx.From} → {tx.To}: {tx.Value}");

// Next page
var nextPage = await historyQuery.MoveNextPageAsync(transactions);

Trust Relationships

Query who trusts whom:

csharp

var trustQuery = new GetTrustRelationsQuery(client);
var relations = await trustQuery.SendRequestAsync("0xAvatarAddress", 20);

foreach (var r in relations.Response)
    Console.WriteLine($"Truster: {r.Truster} → Trustee: {r.Trustee}");

Trust is directional — if A trusts B, B can send personal CRC to A.

Get Avatar Info

Query metadata about a Circles avatar:

csharp

var avatarInfo = new GetAvatarInfoQuery(client);
var info = await avatarInfo.SendRequestAsync("0xAvatarAddress");

This returns the avatar's name, type (human, organization, group), and associated token information.

Token Types

Type	Service	Description
Demurrage	`DemurrageCirclesService`	Balance decreases ~7%/year — represents real purchasing power
Inflationary	`InflationaryCirclesService`	Nominal balance constant — minted amount increases over time

Both are ERC-20 wrappers around the same underlying balance.

Contract Addresses

Contract	Network	Address
Hub V2	Gnosis Chain	`0xc12C1E50ABB450d6205Ea2C3Fa861b3B834d13e8`
RPC	Gnosis Chain	`https://rpc.aboutcircles.com/`
RPC	Chiado Testnet	`https://chiado-rpc.aboutcircles.com`

For full documentation, see: https://docs.nethereum.com/docs/defi/guide-circles

Files

Just SKILL.md in plugins/nethereum-skills/skills/circles of Nethereum/Nethereum.

Open the folder on GitHubat commit 229f278

Compare with similar skills

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

Circles compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Circles this skillNethereum/Nethereum	2.3k	—	~1k	Automated safety check: Pass	MIT	3 days ago
.NET API Compatibility DesignAaronontheweb/dotnet-skills	1.2k	2 repos	~2.7k	Automated safety check: Pass	MIT	21 days ago
Tsp Csharpquerylenshq/ef-querylens	225	—	~1.3k	Automated safety check: Pass	MIT	1 mo ago
XML DocumentationVonage/vonage-dotnet-sdk	118	—	~2.7k	Automated safety check: Pass	Apache-2.0	4 mo ago
Dotnet 10 Csharp 14sketch7/FluentlyHttpClient	121	—	~2.2k	Automated safety check: Pass	MIT	20 days ago
DisCatSharp Discord DevelopmentAiko-IT-Systems/DisCatSharp	140	—	~1.2k	Automated safety check: Pass	MIT	3 days ago

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 4 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 20 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 3 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 yesterday
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 3 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 3 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 3 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 3 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 3 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 3 days ago
Auto-check passed

Works with

Questions about Circles

What does Circles do?

Interact with the Circles UBI protocol using Nethereum (.NET/C). Circles is an agent skill from Nethereum/Nethereum.NET/C).

When should I use Circles?

Circles fits situations like: the user asks about Circles protocol; universal Basic Income; circles balances; trust relationships.

How do I install Circles in Claude Code?

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

How do I install Circles in Codex?

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

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

What does Circles need to run?

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

Does Circles access the network?

SKILL.md names 4 domains. In commands or code: rpc.aboutcircles.com and chiado-rpc.aboutcircles.com; the agent is likely to contact these when it follows the instructions. As links in the text: aboutcircles.com and docs.nethereum.com. This is read from the text; nothing was executed.

Is Circles 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 Circles use?

Circles 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 Circles use?

About 1k tokens (SKILL.md is roughly 4.1k 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 Circles?

Skills that share tags, products or a category with Circles: .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 Circles?

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.

Install Circles

Facts

At a glance

What it does

When your agent uses it

Example prompts

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Circles: UBI Protocol

Query Balances

Hub Contract Interaction

Mint Personal CRC

Transaction History

Trust Relationships

Get Avatar Info

Token Types

Contract Addresses

Files

Compare with similar skills

Similar skills

More from Nethereum/Nethereum

Related

Questions about Circles