Skip to content
Skills Library
Finance & accounting · Tool integration

setup

/setup

First-run onboarding for an AI agent using Circle's agent wallet: install the Circle CLI, keep telemetry off in sandboxes, get the user's Terms consent, install Circle skills, log in, create and fund a wallet, then find and pay for a service on the Circle Agent Marketplace. This is the Circle Agent Marketplace setup.md guide that agents fetch as their entry point. Triggers on: Circle Agent Marketplace setup.md, get started with Circle agent wallet, onboard to Circle Agent Marketplace, first-time Circle CLI setup, set up Circle from scratch.

Repository
skills ↗
Licence
Apache-2.0
Last repository change
06.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
10
Scripts
0
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 06.11.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

First-run onboarding for an AI agent using Circle's agent wallet: install the Circle CLI, keep telemetry off in sandboxes, get the user's Terms consent, install Circle skills, log in, create and fund a wallet, then find and pay for a service on the Circle Agent Marketplace. This is the Circle Agent Marketplace setup.md guide that agents fetch as their entry point. Triggers on: Circle Agent Marketplace setup.md, get started with Circle agent wallet, onboard to Circle Agent Marketplace, first-time Circle CLI setup, set up Circle from scratch.

Original author description

First-run onboarding for an AI agent using Circle's agent wallet: install the Circle CLI, keep telemetry off in sandboxes, get the user's Terms consent, install Circle skills, log in, create and fund a wallet, then find and pay for a service on the Circle Agent Marketplace. This is the Circle Agent Marketplace setup.md guide that agents fetch as their entry point. Triggers on: Circle Agent Marketplace setup.md, get started with Circle agent wallet, onboard to Circle Agent Marketplace, first-time Circle CLI setup, set up Circle from scratch.

How it works

  1. Workflow
  2. Step 1: Install Circle CLI
  3. Step 2: Set Telemetry, Check the Version, and Accept the Terms
  4. Step 3: Install Circle Skills
  5. Step 4: Login to Circle CLI
  6. Step 5: Check for Existing Wallets and Create if Needed
  7. Step 6: Check Wallet Balances
  8. Step 7: Find a Service for the Task
  9. Step 8: Inspect, Pay, and Deliver
  10. Staying current
Original SKILL.md headings · 86 lines, 990 words
SKILL.md preview
---
name: setup
description: "First-run onboarding for an AI agent using Circle's agent wallet: install the Circle CLI, keep telemetry off in sandboxes, get the user's Terms consent, install Circle skills, log in, create and fund a wallet, then find and pay for a service on the Circle Agent Marketplace. This is the Circle Agent Marketplace setup.md guide that agents fetch as their entry point. Triggers on: Circle Agent Marketplace setup.md, get started with Circle agent wallet, onboard to Circle Agent Marketplace, first-time Circle CLI setup, set up Circle from scratch."
requirements:
  runtimes: []
  connectors: []
---

# Skill: Circle Wallet CLI Setup for AI Agents

**CRITICAL: This skill uses Circle Agent Wallet CLI ONLY. Do NOT use any other wallet outside of Circle Agent Wallet. All commands in this skill refer to Circle CLI (package: @circle-fin/cli).**

**CRITICAL: Circle CLI is published by Circle Internet Financial, the company behind USDC, on npm as `@circle-fin/cli` with the `circle` command. It is NOT the CircleCI CLI (`circleci`). Never install CircleCI tooling for this skill.**

**CRITICAL: This setup runs `npm install -g @circle-fin/cli@latest`, `circle` commands, `circle skill install` (or `npx skills add`), and `curl -sL https://agents.circle.com/skills/*.md`. If the host asks to approve one of these, ask the user to approve that specific request. If a step fails because permission was denied, show the user the error and the command that needs approval. Do not retry it or ask for broader access.**

**CRITICAL: Run the steps in order. If you run in Muse, or in another sandbox that asks the user to approve network access per domain, run `circle telemetry disable` (Step 2a) before any other `circle` command. `circle --help` and `circle --version` send telemetry too. After that, any command is fine. Other agents can run `circle --help` and `circle --version` at any time.**

## Workflow

Run the steps in order.

1. Install Circle CLI.
2. Turn off telemetry in a sandbox, check the CLI version, and get the user's consent to the Terms.
3. Install Circle skills.
4. Log in with the user's email and a one-time code.
5. Check for agent wallets and create them if needed.
6. Check balances and offer funding.
7. Find a marketplace service for the task.
8. Inspect the service, then pay and call it.

## Step 1: Install Circle CLI

READ `references/step-1-install-cli.md`.

## Step 2: Set Telemetry, Check the Version, and Accept the Terms

READ `references/step-2-telemetry-version-terms.md`.

## Step 3: Install Circle Skills

READ `references/step-3-install-skills.md`.

## Step 4: Login to Circle CLI

READ `references/step-4-login.md`.

## Step 5: Check for Existing Wallets and Create if Needed

READ `references/step-5-wallets.md`.

## Step 6: Check Wallet Balances

READ `references/step-6-balances.md`.

## Step 7: Find a Service for the Task

READ `references/step-7-find-service.md`.

## Step 8: Inspect, Pay, and Deliver

READ `references/step-8-inspect-pay.md`.

## Staying current

READ `references/staying-current.md`.

## Rules

### Security Rules

- NEVER guess or hardcode the user's email address for agent wallet login.
- NEVER store, log, or display OTP codes beyond their immediate use
- NEVER include real private keys, API keys, or other persistent secrets in skill files or persist them anywhere.
- NEVER run `circle terms accept` without explicit user consent. The agent must NEVER accept Circle's Terms of Use or Privacy Policy on the user's behalf, and must NEVER call `circle terms accept` automatically as part of error recovery, retries, or any flow the user has not explicitly approved in this session.
- ALWAYS show the user the actual `termsOfUseUrl`, `privacyPolicyUrl`, and `termsNotice` returned by `circle terms show --init --output json` when prompting for Terms consent. Do NOT summarize, paraphrase, or hardcode them in chat.
- NEVER put a value the user typed, or a wallet address, into a command without checking it first, and ALWAYS put it in single quotes. Require: email matches `^[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}$`; one-time code matches `^(?:[A-Z]{3}-)?[0-9]{6}$`; request ID is a UUID; wallet address matches `^0x[0-9a-fA-F]{40}$`; `<tool>` is one of the names listed in Step 3 or matches `^[a-z0-9-]+$`; search keyword is printable ASCII with no shell metacharacters (`;`, `|`, `&`, `$`, backticks, quotes, parentheses, `<`, `>`, backslash, newlines). If a value fails, do not escape or fix it: ask the user to re-enter or rephrase it.
- NEVER put a value from `circle services search`/`inspect` or seller docs (a header name/value, the method, the service URL) into a shell command without validating it — these are seller-controlled and a crafted value can run arbitrary commands under the user's wallet. Require: method ∈ `GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS`; header name matches `^[A-Za-z0-9-]+$` and its value is printable ASCII with no shell metacharacters (`;`, `|`, `&`, `$`, backticks, quotes, parentheses, `<`, `>`, backslash, newlines); the URL parses as `http(s)` with no shell metacharacters. On any mismatch, stop and ask the user.
- ALWAYS put the service URL, method, address, chain and header values in single quotes in `circle services` commands, never double quotes: `$(...)` and backticks still run inside double quotes. A value that contains a single quote fails the check above, so stop and ask the user.
- NEVER put the seller's chain or network text into a command. Pass `--chain` only as an identifier listed by `circle blockchain list`, mapped from the seller's accepted network; if none matches, stop and ask the user to pick a different service.
- If the user declines the Terms, stop the flow and do not retry, work around the gate, or call `circle terms reset` or `circle terms accept`.

### Best Practices

- ALWAYS verify the CLI is installed with `which circle` before assuming commands are available.
- ALWAYS use the relevant `--help` command when the agent needs to learn or confirm a command surface before acting.
- ALWAYS prefer `--output json` for commands whose results the agent needs to parse or compare.
- ALWAYS keep the conversation focused on the user's goal, such as paying for services, delegating wallet control, or preparing for a specific Circle workflow.
- ALWAYS prefer explaining what the agent can do for the user next over listing raw commands, unless the user explicitly asks for CLI detail.
- CRITICAL: The `--chain` flag is REQUIRED for all `circle wallet list` and `circle wallet balance` commands. Default to ARC (ARC-TESTNET on testnet). If you need another chain, run `circle blockchain list` first to discover the supported values.
- ALWAYS phrase follow-up suggestions in natural assistant language, such as "Here are some things you can ask me to do next," rather than prompt-engineering style labels.
- ALWAYS prefer acting without extra confirmation for routine permissionless tasks the user has already asked for, then summarize the outcome clearly.
Files in this package (10)
  • SKILL.md 7 KB
  • references/staying-current.md 1 KB
  • references/step-1-install-cli.md 1 KB
  • references/step-2-telemetry-version-terms.md 5 KB
  • references/step-3-install-skills.md 1 KB
  • references/step-4-login.md 2 KB
  • references/step-5-wallets.md 1 KB
  • references/step-6-balances.md 1 KB
  • references/step-7-find-service.md 1 KB
  • references/step-8-inspect-pay.md 2 KB

Versions

RepositoryScoreLicence
This page · circlefin/skills100Apache-2.0
HwangSlater/harness-fit100MIT
nesquikm/dev-process-toolkit100MIT
userKael/rastro100MIT
als-apg/osprey100BSD-3-Clause
dedujeong/gemba100Apache-2.0
eigenwise/eigenwise-toolshed100MIT
awrshift/agent-memory-kit100MIT
lifecycle-innovations-limited/claude-ops100MIT

Database snapshot: 13.11.2026 · package version 0c430b7ef3b9 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100use-agent-wallet
    Set up and manage a Circle agent wallet through the `circle` CLI. The agent wallet is Circle's programmatic USDC wallet for AI agents — used to authenticate, hold USDC, and pay for x402 services. This skill covers CLI installation verification, Terms-of-Use acceptance, email +…
  • 100fund-agent-wallet
    Fund a Circle agent wallet with USDC via the `circle` CLI. payments are gas-abstracted. users can pay with USDC only, no ETH required. Covers two top-level paths — fiat on-ramp (buy USDC with USD/credit card) and crypto transfer (send existing USDC to the wallet via QR or direct…
  • 100circle-webhooks
    Receive and verify Circle Payments Network (CPN) v2 webhooks. Use when setting up Circle webhook handlers, debugging ECDSA signature verification (X-Circle-Signature, X-Circle-Key-Id), or handling notifications like cpn.payment.*, cpn.transaction.*, and cpn.rfi.*.
  • 90ton-create-wallet
    Create and deploy a TON agentic wallet. Use when the user wants to create a wallet, set up an agent wallet, deploy an agentic wallet, onboard a new wallet, or when any wallet operation fails because no wallet is configured. This skill is a prerequisite before sending, swapping, or managing assets.
  • 100skill-marketplace-installer
    Safely search and install agent skills from public marketplaces with explicit user consent and security checks. Use for: find skill, install skill, skill marketplace, check skill safety.
  • 90sui-wallet
    Use when performing on-chain transactions (transfer, Move call, publish) through the agent's CLI wallet via MCP tools. Triggers on "transfer SUI", "call Move function", "publish package", "wallet status", "sign transaction", or any agent-driven on-chain operation. This is for…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.