New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Agent Wallet Policy

by circlefin in circlefin/skills

View spending policy on a Circle agent wallet — per-transaction, daily, weekly, and monthly USDC caps via the circle CLI.

Apache-2.0Auto-check passedBackend & APIs

Install Agent Wallet Policy

skills CLI
$ npx skills add circlefin/skills --skill agent-wallet-policy -a claude-code

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

GitHub CLI
$ gh skill install circlefin/skills agent-wallet-policy --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/circlefin/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/circle/skills/agent-wallet-policy .claude/skills/agent-wallet-policy && 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
agent-wallet-policy
GitHub stars
155
Token cost
~1.7k tokens
SKILL.md length
877 words
Files
2 (incl. references)
Skills in repo
18
Repo updated
First seen
Licence
Apache-2.0

At a glance

View spending policy on a Circle agent wallet — per-transaction, daily, weekly, and monthly USDC caps via the circle CLI.

  • Works in 3 steps: Confirm values with the user → Hand the user the command → Verify after the user reports done
  • The user wants to inspect current limits
  • SKILL.md covers Overview, Prerequisites, Viewing current limits… and Setting or resetting limits…, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Agent Wallet Policy is an agent skill from circlefin/skills. View spending policy on a Circle agent wallet — per-transaction, daily, weekly, and monthly USDC caps via the circle CLI. Use when the user wants to inspect current limits. Setting or resetting limits requires OTP confirmation in an interactive terminal session — the agent hands the user a verbatim command to run themselves; the OTP must never pass through agent storage. Mainnet-only — testnet chains are rejected. Triggers on: spending limit, spending policy, per-tx cap, daily cap, weekly cap, monthly cap, wallet…

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/commands.md`).

It sits in Backend & APIs. It works with Circle USDC. The repository describes itself as: Circle's open source skills for AI-assisted development. The licence is Apache-2.0.

When your agent uses it

  • The user wants to inspect current limits
  • : spending limit
  • Spending policy
  • OTP confirmation

Example prompts

  • “/agent-wallet-policy”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Confirm values with the user
  2. Hand the user the command
  3. Verify after the user reports done

What it can do on your machine

Read from SKILL.md and the folder at commit 58ab864. 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 bash).

    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):

    • agents.circle.com
    • developers.circle.com
    • console.circle.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

Agent Wallet Policy loads about 1.7k tokens when it runs, and up to ~2k if it reads all its reference files. Until then it costs about 141 tokens; SKILL.md has 877 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~141
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2k

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 circlefin/skills at commit 58ab864, republished under its Apache-2.0 licence (© circlefin). 877 words, ~1,735 tokens.

Download SKILL.mdSave it as .claude/skills/agent-wallet-policy/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
agent-wallet-policy
description
View spending policy on a Circle agent wallet — per-transaction, daily, weekly, and monthly USDC caps via the `circle` CLI. Use when the user wants to inspect current limits. Setting or resetting limits requires OTP confirmation in an interactive terminal session — the agent hands the user a verbatim command to run themselves; the OTP must never pass through agent storage. Mainnet-only — testnet chains are rejected. Triggers on: spending limit, spending policy, per-tx cap, daily cap, weekly cap, monthly cap, wallet rules, OTP confirmation.

Overview

For an overview of the Circle CLI's full capability set, see the use-circle-cli master skill. This skill is the narrower spending-policy flow.

Circle agent wallets support spending policies — per-wallet caps that the CLI enforces on every payment and transfer. There are three operations:

OperationCommandOTP required?
View current limitscircle wallet limit --address <addr> --chain ARC --output jsonNo
Set custom limitscircle wallet limit set ...Yes — human OTP, run in user's own terminal
Reset to defaultscircle wallet limit reset ...Yes — human OTP, run in user's own terminal

Spending policies are mainnet-only (testnet chains are rejected; see Troubleshooting / Rules).

Prerequisites

Two supporting commands set up the flow: a session check (circle wallet status) and a wallet-address lookup (circle wallet list ... --output json). READ references/commands.md for the exact commands.

If circle wallet status errors with "Not logged in" or "Terms acceptance is required", hand off to the use-agent-wallet skill — it covers install, terms, login, and wallet creation.

Viewing current limits (in-agent, no OTP)

bash
circle wallet limit --address <addr> --chain ARC --output json

Shows the current per-tx, daily, weekly, and monthly USDC caps (null for any unset tier). Safe to call freely — read-only, no money moves, no OTP.

Setting or resetting limits (interactive terminal — handoff to user)

circle wallet limit set and circle wallet limit reset are interactive. They send a 6-digit OTP to the user's email mid-execution and wait for the code at the CLI's stdin prompt.

OTPs are password-equivalent. The agent must NOT receive, store, or relay the OTP. The agent's job here is to hand the user a verbatim command to run in their own terminal, then wait for them to report back.

1. Confirm values with the user

Limits must be monotonic: per-tx ≤ daily ≤ weekly ≤ monthly.

A typical conservative configuration:

TierSuggested USDC value
--per-tx1
--daily5
--weekly20
--monthly50

Adjust based on the user's stated tolerance. Get explicit yes before generating the command.

2. Hand the user the command

Tell the user:

Setting spending limits requires an OTP I shouldn't see. Please run this command in your own terminal — the CLI will email you a 6-digit code; enter it at the prompt. Let me know once it completes.

bash
circle wallet limit set \
  --address <addr> --chain ARC \
  --policy-type stablecoin \
  --per-tx 1 --daily 5 --weekly 20 --monthly 50

For reset, the verbatim command is:

bash
circle wallet limit reset --address <addr> --chain ARC --yes

Omit --yes if you want the user to see a confirmation prompt before the OTP is sent.

3. Verify after the user reports done

Run the read-only limit command to confirm the new caps, then surface them to the user. READ references/commands.md for the exact command.

Troubleshooting

SymptomCauseFix
User received multiple OTP emailsCommand was re-run while a previous invocation was still waitingTell the user to use the most recent OTP only. Earlier ones are invalidated.
OTP rejected with "prefix mismatch"User entered an OTP from a previous requestRestart — each set / reset invocation has a fresh prefix.
Spending policies are mainnet-onlyTried to set a policy on a testnet chainRe-run with a mainnet --chain value (BASE, MATIC, etc.).
Limits must be monotonicper-tx > daily, daily > weekly, etc.Re-check the values. per-tx ≤ daily ≤ weekly ≤ monthly.
Only agent wallets support spending policiesTried on a local (non-agent) walletSpending policies apply only to agent wallets created via circle wallet create.
Show full SKILL.md (332 more words)Show less

Rules

  • NEVER ask the user to share the OTP with you. The OTP must go directly from the user's email to the CLI prompt in their own terminal — it should never touch the agent's context, tool calls, or any local file.
  • If email- or messaging-integration tools are connected (e.g., Gmail or Slack via MCP), the OTP can also be fetched through them — note the option to the user; how to handle it is their call.
  • ALWAYS hand the user a verbatim circle wallet limit set / reset command for them to run in their own terminal. Do NOT try to orchestrate the OTP from chat.
  • ALWAYS confirm proposed limit values with the user before generating the command. Show the per-tx / daily / weekly / monthly numbers explicitly and wait for explicit yes.
  • Spending policies are mainnet-only — testnet chains are rejected. Don't quote testnet examples.
  • Only agent wallets support spending policies, not local wallets.
  • After the user reports the change is done, run circle wallet limit --address <addr> --chain ARC --output json so the user sees the new caps.

Alternatives

Trigger the use-agent-wallet skill instead when:

  • The user has not yet logged in to the CLI or accepted Terms.
  • circle wallet status errors with "Not logged in" or "Terms acceptance is required".
  • The user is asking about wallet setup, login, or session state — not policy.

Trigger the pay-via-agent-wallet skill instead when:

  • The user wants to call, pay for, or use a paid x402 service.
  • Limits are already set and the user is ready to spend.

Trigger the fund-agent-wallet skill instead when:

  • The user wants to add USDC before setting limits.
  • The user mentions deposit, fiat on-ramp, fiat purchase, QR-code transfer, or Gateway deposit.

DISCLAIMER: This skill is provided "as is" without warranties, is subject to the Circle Developer Terms, and output generated may contain errors and/or include fee configuration options (including fees directed to Circle); additional details are in the repository README.

© circlefin, Apache-2.0. 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 1 other file (references) in plugins/circle/skills/agent-wallet-policy of circlefin/skills.

  • SKILL.md
  • references/commands.md

Open the folder on GitHubat commit 58ab864

Compare with similar skills

Agent Wallet Policy 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.

Agent Wallet Policy compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Agent Wallet Policy this skillcirclefin/skills155—~1.7kAutomated safety check: PassApache-2.0
Agentic Walletcoinbase/agentic-wallet-skills1272 repos~1kAutomated safety check: PassMIT
Deposit QrSuperior-Trade/superior-skills214—~1.1kAutomated safety check: PassMIT
Alchemy Agentic Gatewaymoonpay/skills113—~2.1kAutomated safety check: NotesMIT
Mppxinternet-court/internet-court-skill6.5k1 repos~1.1kAutomated safety check: PassApache-2.0
CapacitrBankrBot/skills1.2k—~3kAutomated safety check: PassNone

Similar skills

  • Agentic Wallet

    coinbase/agentic-wallet-skills

    Crypto wallet operations via the awal CLI — sign in, check balances, send USDC/ETH/POL/SOL, trade tokens, fund the wallet, and use the x402 payment protocol to discover paid services, pay for API…

    127 GitHub starsUsed in 2 repos~1k tokens
    Backend & APIsAuto-check passed

  • Deposit Qr

    Superior-Trade/superior-skills

    A skill your agent uses when a user needs a QR code or wallet payment URI to fund a Superior-managed EVM wallet on a specific chain before using Lighter, Polymarket, Hyperliquid, or other Superior…

    214 GitHub stars~1.1k tokensUpdated 29 days ago
    Backend & APIsAuto-check passed

  • Alchemy Agentic Gateway

    moonpay/skills

    A skill your agent uses when accessing Alchemy APIs for RPC calls, token balances, NFT metadata, asset transfers, transaction simulation, or Alchemy-specific features.

    113 GitHub stars~2.1k tokensUpdated 29 days ago
    Backend & APIsAuto-check: notes

  • Mppx

    internet-court/internet-court-skill

    TypeScript SDK for the Payment HTTP Authentication Scheme. An agent skill from internet-court/internet-court-skill.

    6.5k GitHub starsUsed in 1 repo~1.1k tokens
    Backend & APIsAuto-check passed

  • Capacitr

    BankrBot/skills

    Paste a URL or free text and get matched Polymarket / Hyperliquid / Deribit markets with Quotient edge scores.

    1.2k GitHub stars~3k tokensUpdated 4 days ago
    Backend & APIsAuto-check passed

  • Uniswap V3 Swap

    keypo-us/keypo-cli

    A skill your agent uses when the user wants to swap tokens on Base Sepolia (or Base mainnet) using Uniswap V3.

    182 GitHub stars~3.2k tokensUpdated 6 mo ago
    Backend & APIsAuto-check passed

More from circlefin/skills

All 18 skills in this repo

  • Recover Eco Funds

    circlefin/skills

    Recover USDC from a legacy Circle CLI Gateway --method eco deposit whose fixed refund recipient is the SCA's backing EOA.

    155 GitHub stars~5.1k tokensUpdated 23 days ago
    Auto-check passed

  • Bridge Stablecoin

    circlefin/skills

    Build browser or server USDC bridging with Circle App Kit or standalone Bridge Kit and CCTP.

    155 GitHub stars~3.4k tokensUpdated 23 days ago
    Auto-check: notes

  • Fund Agent Wallet

    circlefin/skills

    Fund a Circle agent wallet with USDC via the circle CLI. An agent skill from circlefin/skills.

    155 GitHub stars~3.4k tokensUpdated 23 days ago
    Auto-check passed

  • Accept Agent Payments

    circlefin/skills

    A skill your agent uses when a developer wants to monetize an API, endpoint, service, model, dataset, tool, or agent-facing resource with Circle USDC pay-per-call payments, Gateway Nanopayments…

    155 GitHub stars~2.6k tokensUpdated 23 days ago
    Auto-check: warnings

  • Pay Via Agent Wallet

    circlefin/skills

    A skill your agent uses when the user wants to call a paid API, look something up online, search for data, get prices, odds, or stats, or use any paid service with automatic USDC payment.

    155 GitHub stars~3.9k tokensUpdated 23 days ago
    Auto-check passed

  • Swap Tokens

    circlefin/skills

    Build browser or server token swaps with Circle App Kit or standalone Swap Kit.

    155 GitHub stars~4.6k tokensUpdated 23 days ago
    Auto-check: notes

Works with

Categories

Questions about Agent Wallet Policy

What does Agent Wallet Policy do?

View spending policy on a Circle agent wallet — per-transaction, daily, weekly, and monthly USDC caps via the circle CLI. Agent Wallet Policy is an agent skill from circlefin/skills. View spending policy on a Circle agent wallet — per-transaction, daily, weekly, and monthly USDC caps via the circle CLI.

When should I use Agent Wallet Policy?

Agent Wallet Policy fits situations like: the user wants to inspect current limits; : spending limit; spending policy; OTP confirmation.

How do I install Agent Wallet Policy in Claude Code?

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

How do I install Agent Wallet Policy in Codex?

Run `npx skills add circlefin/skills --skill agent-wallet-policy -a codex`. Or copy the skill folder (plugins/circle/skills/agent-wallet-policy in circlefin/skills) into .agents/skills/agent-wallet-policy in your project. Codex loads it when a task matches its description.

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

What does Agent Wallet Policy need to run?

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

Does Agent Wallet Policy access the network?

SKILL.md names 3 domains. As links in the text: agents.circle.com, developers.circle.com and console.circle.com. This is read from the text; nothing was executed.

Is Agent Wallet Policy 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 Agent Wallet Policy use?

Agent Wallet Policy is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Agent Wallet Policy use?

About 1.7k tokens (SKILL.md is roughly 6.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 251 tokens, read only when the agent opens those files.

What are the alternatives to Agent Wallet Policy?

Skills that share tags, products or a category with Agent Wallet Policy: Agentic Wallet (coinbase/agentic-wallet-skills, 127 stars), Deposit Qr (Superior-Trade/superior-skills, 214 stars), Alchemy Agentic Gateway (moonpay/skills, 113 stars) and Mppx (internet-court/internet-court-skill, 6.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agent Wallet Policy?

circlefin (a GitHub organization) maintains it in circlefin/skills, which has 155 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on September 16, 2026.

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