Skip to content

OliverDevDS/skills

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Circle Skills

Circle Skills

Ship stablecoin apps faster with Circle Skills: best-practice guidance for USDC payments, crosschain transfers, wallets, and smart contracts, plus Circle's MCP server for real-time SDK and documentation context.

X Discord YouTube Circle Developer Docs Arc USDC Contracts

Installation

Claude Code

/plugin marketplace add circlefin/skills
/plugin install circle-skills@circle

Vercel Skills CLI

npx skills add circlefin/skills

Skills

Skill Description
use-usdc Interact with USDC on EVM chains and Solana. Check balances, send transfers, approve spending, and verify transactions.
bridge-stablecoin Crosschain USDC transfers using CCTP (Crosschain Transfer Protocol). Includes UX patterns, progress tracking, and Bridge Kit SDK implementation.
use-arc Build on Arc, Circle's blockchain where USDC is the native gas token. Covers chain configuration, contract deployment, and bridging USDC to Arc via CCTP.
use-circle-wallets Choose the right Circle wallet type. Compares developer-controlled, user-controlled, and modular (passkey) wallets across custody model, key management, and use cases.
use-developer-controlled-wallets Developer-controlled wallets for custodial flows like payouts, treasury management, and automation. Developers manage wallet creation and key storage.
use-gateway Unified USDC balance across chains with instant crosschain transfers (<500ms). Supports EVM and Solana with deposit, balance query, and transfer workflows.
use-modular-wallets Smart contract wallets with passkey authentication, gasless transactions, and modular architecture. Supports ERC-4337 account abstraction.
use-smart-contract-platform Deploy, import, interact with, and monitor smart contracts using Circle's Smart Contract Platform. Supports bytecode deployment, template contracts (ERC-20/721/1155), ABI-based read/write calls, and event monitoring.
use-user-controlled-wallets Embedded wallets where users control their own assets. Supports Web2-like login (Google, Facebook, Apple, email OTP, PIN) without seed phrases.

Circle MCP

Skills contain stable patterns (architecture decisions, UX guidance, common mistakes). For ground-truth details that change frequently (e.g., SDK method signatures, contract addresses, chain IDs) use Circle's MCP server alongside skills.

Client Setup
Cursor Add to ~/.cursor/mcp.json
Claude Code claude mcp add --transport http circle https://api.circle.com/v1/codegen/mcp --scope user
Codex codex mcp add circle --url https://api.circle.com/v1/codegen/mcp
Windsurf Add to ~/.codeium/windsurf/mcp_config.json

Manual config for Cursor, Windsurf, and other JSON-based clients:

{
 "mcpServers": {
   "circle": {
     "url": "https://api.circle.com/v1/codegen/mcp"
   }
 }
}

Full setup guide: developers.circle.com/ai/mcp

How Skills Work

Skills provide context that help agents do specific things with greater accuracy:

  • Decision frameworks: when to use CCTP vs Gateway, which wallet type fits your use case
  • Correct patterns: USDC's 6-decimal rule, approve-then-deposit flows, passkey recovery
  • Common mistakes: what breaks and why, so the agent avoids them upfront

Your agent reads the relevant SKILL.md while planning and generating code. You stay in control of what gets built.

Updating

Skills are local files. To get the latest versions:

# Vercel CLI
npx skills update

# Claude Code
/plugin marketplace update

Skills are designed around patterns with infrequent changes, so they remain useful even if slightly behind. For details that change often (contract addresses, SDK signatures), use Circle MCP which updates over the air.

Contributing

We accept issues openly — bug reports, skill requests, and feedback are welcome. We review community suggestions and use them to guide what we build, but don't guarantee merging external contributions.

FAQ

Do skills write code for me? No. Skills are instructions and best-practice patterns that steer an agent's outputs. Your agent generates the code; skills guide it.

Do I need the MCP server? No. Skills work standalone. MCP adds accuracy for SDK details that change between versions.

Resources

Disclaimer

By using this skill, you acknowledge that any output generated in connection with the Skill may contain errors, omissions, outdated information, or fee configuration options, including options under which applicable fees may be directed to Circle Technology Services, LLC, and you are solely responsible for reviewing and validating all outputs and fee settings before taking any action. This skill is provided "as is," and Circle Technology Services, LLC disclaims liability for losses or damages arising from use of or reliance on output generated in connection with this skill; use of this skill is subject to the Circle Developer Terms and Conditions.

License

Apache 2.0 — see LICENSE for details.

About

Circle's open source skills for AI-assisted development.

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors