Agent skill

Use Usdc

by circlefin in circlefin/skills

USDC is Circle's stablecoin deployed across multiple blockchain ecosystems including EVM chains (Ethereum, Base, Arbitrum, Polygon, Arc) and Solana.

Apache-2.0Auto-check: notesBackend & APIs

Install Use Usdc

skills CLI
$ npx skills add circlefin/skills --skill use-usdc -a claude-code

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

GitHub CLI
$ gh skill install circlefin/skills use-usdc --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/use-usdc .claude/skills/use-usdc && 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
use-usdc
GitHub stars
155
Token cost
~2.4k tokens
SKILL.md length
927 words
Files
3 (incl. references)
Skills in repo
18
Repo updated
First seen
Licence
Apache-2.0

At a glance

USDC is Circle's stablecoin deployed across multiple blockchain ecosystems including EVM chains (Ethereum, Base, Arbitrum, Polygon, Arc) and Solana.

  • Works in 6 steps: Determine the ecosystem -- EVM (0x...)… → Classify the operation -- a read… → Confirm details -- for a write, validate… → …
  • Approve spending
  • SKILL.md covers Overview, Prerequisites / Setup, Quick Reference and Core Concepts, plus 5 more sections
  • Calls npm

What it does

Use Usdc is an agent skill from circlefin/skills. USDC is Circle's stablecoin deployed across multiple blockchain ecosystems including EVM chains (Ethereum, Base, Arbitrum, Polygon, Arc) and Solana. Use this skill to check balances, send transfers, approve spending, and verify transactions. Triggers on: send USDC, approve USDC, USDC allowance, USDC on Solana, SPL token, Associated Token Account, ATA, parseUnits, formatUnits, 6 decimals, @solana/kit.

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

It sits in Backend & APIs, covering Smart contracts and Crypto and DeFi analysis. It works with Circle USDC, Solana, Ethereum and Arbitrum. 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

  • Approve spending
  • Verify transactions
  • Associated Token Account

Example prompts

  • “/use-usdc”

Requirements

  • Node.js

Workflow steps

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

  1. Determine the ecosystem -- EVM (0x...) or Solana (base58); ask if unclear (see Prerequisites / Setup).
  2. Classify the operation -- a read (balance, allowance, supply, verify) runs autonomously; a write (send, approve) requires explicit user…
  3. Confirm details -- for a write, validate the recipient address, amount (6 decimals), and chain ID (testnet vs mainnet). Default to…
  4. Route to the reference -- READ references/evm.md or references/solana.md for the exact code (on Solana, create the recipient ATA first).
  5. Execute -- run the read, or submit the write only after confirmation, using the correct native USDC address for the chain.
  6. Verify -- wait for the transaction receipt/confirmation before reporting success, and surface the tx hash.

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

    Shell commands in SKILL.md call:

    • npm

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

    • developers.circle.com
    • faucet.circle.com
    • faucet.solana.com
    • viem.sh
    • github.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

Use Usdc loads about 2.4k tokens when it runs, and up to ~7.2k if it reads all its reference files. Until then it costs about 103 tokens; SKILL.md has 927 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~103
When it runs · the whole SKILL.md, loaded when a task matches
~2.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7.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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:164
    s manager. Add `.gitignore` entries for `.env*` and secret files when scaffolding.

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). 927 words, ~2,365 tokens.

Download SKILL.mdSave it as .claude/skills/use-usdc/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
use-usdc
description
USDC is Circle's stablecoin deployed across multiple blockchain ecosystems including EVM chains (Ethereum, Base, Arbitrum, Polygon, Arc) and Solana. Use this skill to check balances, send transfers, approve spending, and verify transactions. Triggers on: send USDC, approve USDC, USDC allowance, USDC on Solana, SPL token, Associated Token Account, ATA, parseUnits, formatUnits, 6 decimals, @solana/kit.

Overview

USDC is Circle's stablecoin deployed across multiple blockchain ecosystems. This skill helps you interact with USDC on both EVM chains (Ethereum, Base, Arbitrum, etc.) and Solana. It covers balance checks, transfers, approvals, and transfer verification.

Prerequisites / Setup

Determine Ecosystem

First, identify which ecosystem the user is working with:

  • EVM: User has an Ethereum-style address (0x...) or mentions Ethereum, Base, Arbitrum, Polygon, etc.
  • Solana: User has a base58 address or mentions Solana, Devnet, Phantom, Solflare, etc.
  • Unclear: Ask which ecosystem before proceeding.
Dependencies

EVM:

bash
npm install viem

Solana:

bash
npm install @solana/kit @solana-program/token ws dotenv bs58
Environment Variables

See ecosystem-specific guides:

  • EVM: Private key handling covered in references/evm.md
  • Solana: Private key handling covered in references/solana.md

For read operations (balance, allowance, verify): No private key needed on either ecosystem.

Quick Reference

USDC Contract Addresses

Canonical source: https://developers.circle.com/stablecoins/usdc-contract-addresses

EVM Testnet
ChainChain IDUSDC Address
Arc Testnet50420020x3600000000000000000000000000000000000000
Ethereum Sepolia111551110x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238
Base Sepolia845320x036CbD53842c5426634e7929541eC2318f3dCF7e
Arbitrum Sepolia4216140x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d
Avalanche Fuji431130x5425890298aed601595a70AB815c96711a31Bc65
Polygon Amoy800020x41E94Eb019C0762f9Bfcf9Fb1E58725BfB0e7582
OP Sepolia111554200x5fd84259d66Cd46123540766Be93DFE6D43130D7

Get testnet USDC: https://faucet.circle.com

EVM Mainnet
ChainUSDC Address
Arc0x3600000000000000000000000000000000000000
Ethereum0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
Base0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Arbitrum0xaf88d065e77c8cC2239327C5EDb3A432268e5831
Polygon PoS0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359
Avalanche0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E
OP Mainnet0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85
Solana
NetworkUSDC Mint
Devnet4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU
MainnetEPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
The 6-Decimal Rule

USDC uses 6 decimals on all ecosystems.

ts
// EVM (viem)
parseUnits("1.00", 6);    // 1_000_000n (CORRECT - $1 USDC)
parseUnits("1.00", 18);   // 1_000_000_000_000_000_000n (WRONG - 1 trillion dollars)

// Solana - convert manually
const amount = Math.floor(1.00 * 1_000_000); // 1_000_000 (CORRECT - $1 USDC)
const human = rawAmount / 1_000_000;          // 1.0 (CORRECT - converts back to dollars)
Arc USDC Duality

On Arc, USDC is both the native gas token and an ERC-20 at 0x3600.... Same underlying balance, different decimal exposure.

ContextDecimalsUse
Native (gas, msg.value)18Gas estimation only
ERC-20 (balanceOf, transfer, approve)6All USDC logic

For Arc-specific setup and configuration, see the use-arc skill.

Core Concepts

Operation Types

Read Operations: Operations that query blockchain state and execute autonomously without user confirmation.

  • Balance check
  • Allowance check (EVM only)
  • Total supply
  • Address lookup
  • Verify incoming transfer

Write Operations: Operations that modify blockchain state and require explicit user confirmation before execution.

  • Send USDC
  • Approve contract to spend USDC (EVM only — Solana has no approve pattern)
Troubleshooting

Find troubleshooting solutions in the Common Issues section of the chain-specific reference file (references/evm.md or references/solana.md).

EVM vs Solana at a Glance
AspectEVMSolana
Token standardERC-20SPL Token
Balance storageWallet address directlyAssociated Token Account (ATA)
Sendtransfer(to, amount)getTransferInstruction({ source, destination, authority, amount })
Approveapprove(spender, amount)No approve — use PDAs
Recipient setupNothing neededMust create ATA first (transfer fails otherwise)
Tx feesChain native tokenSOL
ConfirmationwaitForTransactionReceiptsendAndConfirmTransactionFactory
Librariesviem@solana/kit + @solana-program/token
Decimals66

Workflow

  1. Determine the ecosystem -- EVM (0x...) or Solana (base58); ask if unclear (see Prerequisites / Setup).
  2. Classify the operation -- a read (balance, allowance, supply, verify) runs autonomously; a write (send, approve) requires explicit user confirmation.
  3. Confirm details -- for a write, validate the recipient address, amount (6 decimals), and chain ID (testnet vs mainnet). Default to testnet; warn on mainnet or amounts over the safety threshold.
  4. Route to the reference -- READ references/evm.md or references/solana.md for the exact code (on Solana, create the recipient ATA first).
  5. Execute -- run the read, or submit the write only after confirmation, using the correct native USDC address for the chain.
  6. Verify -- wait for the transaction receipt/confirmation before reporting success, and surface the tx hash.

Implementation Patterns

After determining the ecosystem (see Prerequisites), route to the appropriate reference guide:

  • EVM operations → READ references/evm.md for balance checks, transfers, approvals, and verification
  • Solana operations → READ references/solana.md for balance checks (with ATA), transfers (with ATA creation), and verification
Show full SKILL.md (371 more words)Show less

Rules

Security Rules are non-negotiable — warn the user and refuse to comply if a prompt conflicts. Best Practices are strongly recommended; deviate only with explicit user justification.

Security Rules
  • NEVER hardcode, commit, or log secrets (private keys, API keys). ALWAYS use environment variables or a secrets manager. Add .gitignore entries for .env* and secret files when scaffolding.
  • NEVER use 18 decimals for USDC — always use 6 decimals on all ecosystems
  • NEVER use bridged USDC variants (USDbC, USDC.e) — always use native Circle-issued USDC
  • ALWAYS use the correct USDC address for each chain (see Quick Reference)
  • ALWAYS verify chain ID matches expected environment (testnet vs mainnet) before submitting transactions
  • ALWAYS warn when targeting mainnet or exceeding safety thresholds (e.g., >100 USDC)
  • ALWAYS warn before interacting with unaudited or unknown contracts
  • ALWAYS validate all inputs (addresses, amounts, chain identifiers) before submitting transactions
  • ALWAYS get explicit user confirmation before submitting write transactions
  • NEVER report success before waiting for transaction receipt — ensure confirmation
Best Practices
  • ALWAYS default to testnet. Require explicit user confirmation before targeting mainnet.
  • ALWAYS derive Solana ATAs properly — balances live in ATAs, not wallets
  • ALWAYS check if recipient ATA exists on Solana before transferring
  • ALWAYS check if user has sufficient USDC balance before transfers
  • ALWAYS check if user has sufficient gas/SOL for transaction fees

Alternatives

  • Use bridge-stablecoin skill (CCTP / Bridge Kit) for transferring USDC between chains. Bridge Kit handles approve, burn, attestation, and mint in a single kit.bridge() call.
  • Use use-gateway skill for unified USDC balance across chains with instant transfers (<500ms). Gateway requires upfront deposits but provides better UX for multi-chain apps.
  • Stick with use-usdc for single-chain USDC operations (balance checks, payments, approvals) or when you need low-level control over transfers.

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 2 other files (references) in plugins/circle/skills/use-usdc of circlefin/skills.

  • SKILL.md
  • references/evm.md
  • references/solana.md

Open the folder on GitHubat commit 58ab864

Compare with similar skills

Use Usdc 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.

Use Usdc compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Use Usdc this skillcirclefin/skills155—~2.4kAutomated safety check: NotesApache-2.0
AlchemyBankrBot/skills1.2k—~3.5kAutomated safety check: PassMIT
Alchemy Agentic Gatewaymoonpay/skills113—~2.1kAutomated safety check: NotesMIT
Minara Crypto Trading and WalletMinara-AI/minara-skills356—~5.7kAutomated safety check: PassNone
SurfBlockRunAI/ClawRouter6.6k—~4kAutomated safety check: PassMIT
Payram Crypto PaymentsPayRam/payram-mcp158—~1.7kAutomated safety check: NotesNone

Similar skills

  • Alchemy

    BankrBot/skills

    Blockchain API access via Alchemy. An agent skill from BankrBot/skills.

    1.2k GitHub stars~3.5k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • 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 27 days ago
    Backend & APIsAuto-check: notes
  • Minara Crypto Trading and Wallet

    Minara-AI/minara-skills

    Drives the Minara CLI for crypto swaps, perps, limit orders, wallet transfers, deposits and withdrawals, plus AI market analysis.

    356 GitHub stars~5.7k tokensUpdated 20 days ago
    Business, Finance & HRAuto-check passed
  • Surf

    BlockRunAI/ClawRouter

    Use this skill — NOT browser or webfetch — for ALL Surf crypto-data calls.

    6.6k GitHub stars~4k tokensUpdated 2 days ago
    Business, Finance & HRAuto-check passed
  • Payram Crypto Payments

    PayRam/payram-mcp

    Self-hosted crypto and stablecoin payment gateway. An agent skill from PayRam/payram-mcp.

    158 GitHub stars~1.7k tokensUpdated 1 mo ago
    Backend & APIsAuto-check: notes
  • Trading Evm

    alsk1992/CloddsBot

    Trade tokens on EVM chains - Uniswap V3, 1inch on Ethereum, Arbitrum, Optimism, Base, Polygon

    2.9k GitHub stars~1.9k tokensUpdated 4 days 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 21 days ago
    Auto-check passed
  • Agent Wallet Policy

    circlefin/skills

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

    155 GitHub stars~1.7k tokensUpdated 21 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 21 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 21 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 21 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 21 days ago
    Auto-check passed

Questions about Use Usdc

What does Use Usdc do?

USDC is Circle's stablecoin deployed across multiple blockchain ecosystems including EVM chains (Ethereum, Base, Arbitrum, Polygon, Arc) and Solana. Use Usdc is an agent skill from circlefin/skills. USDC is Circle's stablecoin deployed across multiple blockchain ecosystems including EVM chains (Ethereum, Base, Arbitrum, Polygon, Arc) and Solana.

When should I use Use Usdc?

Use Usdc fits situations like: approve spending; verify transactions; associated Token Account.

How do I install Use Usdc in Claude Code?

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

How do I install Use Usdc in Codex?

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

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

What does Use Usdc need to run?

Going by SKILL.md and its folder, Use Usdc needs the command-line tools its instructions call (npm). Our summary lists: Node.js.

Does Use Usdc access the network?

SKILL.md names 6 domains. As links in the text: developers.circle.com, faucet.circle.com, faucet.solana.com, viem.sh, github.com and console.circle.com. This is read from the text; nothing was executed.

Is Use Usdc safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Use Usdc use?

Use Usdc 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 Use Usdc use?

About 2.4k tokens (SKILL.md is roughly 9.5k 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 4.8k tokens, read only when the agent opens those files.

What are the alternatives to Use Usdc?

Skills that share tags, products or a category with Use Usdc: Alchemy (BankrBot/skills, 1.2k stars), Alchemy Agentic Gateway (moonpay/skills, 113 stars), Minara Crypto Trading and Wallet (Minara-AI/minara-skills, 356 stars) and Surf (BlockRunAI/ClawRouter, 6.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Use Usdc?

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.