Emblem Token Swap skill: swap and bridge crypto with EmblemAI
Lets Claude get quotes and run token swaps and cross-chain bridges from your Emblem wallet, using the EmblemAI command line tool.
- Installs
- 8.6K
- on skills.sh
- Stars
- 12
- on GitHub
- Files
- 1
- besides SKILL.md
- Updated
- May 2026
- last repo commit
emblem-token-swap makes Claude run the emblemai CLI to check a balance, get a quote and then execute a swap from your Emblem wallet. It names the exact swap tool per chain, and uses ChangeNow for cross-chain bridges. Bitcoin has balance support but no swap tool.
This skill moves real funds. SKILL.md says swaps need your confirmation in safe mode and that it never bypasses confirmation for value-moving operations. It needs Node.js 18 or newer and the @emblemvault/agentwallet CLI.
Good for
- Crypto users who want to swap tokens on Solana, Ethereum, Base, BSC, Polygon or Hedera by chat
- People bridging assets between chains through ChangeNow
- Developers who already use the emblemai CLI
Install emblem-token-swap
Claude Code
- 1
Copy this prompt.
Install the emblem-token-swap skill in Claude Code. Run this command: npx skills add EmblemCompany/Agent-skills --skill emblem-token-swap Then check that it loaded and tell me how to use it.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Node.js 18 or newer.
The skill calls the emblemai command, so the CLI must be installed first. The repo README also describes a hosted EmblemAI MCP server for agents that want to call Emblem tools without the CLI; that is a separate setup. We store no Claude app upload because the skill runs a local CLI.
From the project README. Source.
What's in the skill
When it loads
Execute token swaps across 6 blockchains via EmblemAI. Automatic route optimization and cross-chain bridging via ChangeNow. Use when the user wants to swap tokens, exchange crypto, convert between currencies, or bridge assets cross-chain.
Sections in SKILL.md
- What This Skill Can Do
- Notes
- Quick Start
- Workflow: Safe Token Swap
- Step 1: Check Balance
- Step 2: Get a Quote
- Step 3: Execute the Swap
- Step 4: Verify
- Swap Patterns
- Solana Swaps
- EVM Swaps
- Hedera Swaps
- Cross-Chain Bridge
- Communication Rules
- Safety
- Helper Script
Key facts
- Installs on skills.sh
- 8,595 as of 2026-11-02
- skills.sh audits
- Gen Agent Trust Hub pass, Socket pass, Snyk warn
- What is inside
- 2 files: SKILL.md and scripts/swap-helper.sh
- Last repo commit
- 2026-05-15
What it includes
Quotes and swaps on Solana
Handles token lookup by name, symbol or address, and amounts in USD, SOL or token quantity. Used for both quote and swap.
Try: “Use splBuyIntent to get a quote for swapping 5 SOL to USDC.”
Runs code ·
splBuyIntentQuotes and swaps on Ethereum
Routes through DEX aggregation. The same pair pattern exists as baseSwapQuote and baseSwap, bscSwapQuote and bscSwap, and polygonSwapQuote and polygonSwap.
Try: “Use ethSwapQuote to quote 0.01 ETH to USDC.”
Runs code ·
ethSwapQuote and ethSwapQuotes and swaps on Hedera
Quote first, then execute.
Runs code ·
hederaTokensSwapQuote and hederaTokensSwapCross-chain bridge quote and swap
Bridges through ChangeNow, which SKILL.md says supports 500+ currencies. getChangeNowSupportedCurrencies lists them.
Try: “Use getChangeNowSwapQuote to quote bridging 0.1 ETH to SOL.”
Runs code ·
getChangeNowSwapQuote and swapUsingChangeNowCheck funds and find tokens first
solanaBalances, ethGetBalances, baseGetBalances, bscGetBalances, polygonGetBalances and hederaGetBalances check funds. findSolanaSwapToken, searchCryptoByName, searchEvmTokensBirdeye and hederaFindTokens find tokens.
Runs code ·
Balance and token search toolsBalance, quote, execute, verify
Four steps. SKILL.md says safe mode asks for your confirmation before the execute step.
Runs code ·
Safe swap workflowPrints balances and example commands
The script runs one emblemai --agent --profile default prompt that fetches balances on every chain, then prints example swap commands for each chain. The swap commands are printed, not run.
Runs code ·
scripts/swap-helper.sh
From the official docs
Permissions
High risk
This skill can swap and bridge real funds from your Emblem wallet. Ask for quotes first, check every swap before you approve it, and keep only what you can afford to lose in that wallet.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
It can move real funds
The swap and bridge tools execute from your wallet. SKILL.md says safe mode asks for your confirmation first. Our advice: read the amount, route and output token before you approve, keep only what you can lose in the wallet, and do not run it unattended. github.com
First run can create a wallet
The agent-wallet skill says agent mode creates and stores a new wallet when a profile has none. The scripts here use --agent --profile default, so back it up as that skill describes or the wallet cannot be recovered. github.com
It installs a global npm package
You run npm install -g @emblemvault/agentwallet, which is third-party code from EmblemCompany. The agent-wallet skill advises pinning the version and running npm audit signatures. github.com
The helper script calls the CLI for every chain
swap-helper.sh runs one emblemai --agent prompt that asks for balances on every chain, then prints swap commands. It does not run the swaps. github.com
Credentials stay in ~/.emblemai
The agent-wallet security notes list a session file, an encrypted password file and a key file there. Keep them out of backups you share and never paste them into chat. github.com
Security advisories
No published security advisories as of Nov 2, 2026.
Technical details
| Turning on read-only | No read-only mode. SKILL.md has a quote step before the execute step, but it defines no switch that blocks execution. |
|---|---|
| Talks to | EmblemVault service, through the emblemai CLI. ChangeNow for cross-chain bridges |
| Sign-in and keys | The emblemai CLI stores an encrypted password, a key file and a session file under ~/.emblemai/profiles/<name>, per the agent-wallet security notes. |
| Scopes |
|
Questions
What does the Emblem Token Swap skill do?
It makes Claude quote and execute token swaps on six blockchains and bridge assets between chains, using the emblemai CLI. The wallet is the one your Emblem profile holds.
Can it spend my money without asking?
SKILL.md says all swaps require explicit confirmation in safe mode and that the skill never bypasses confirmation for value-moving operations. Our advice: ask for a quote first, read the amount, route and output, use a wallet that holds only what you can afford to lose, and never run swaps from an unattended or scheduled job.
How do I install it?
Use the install box at the top of the page, then install the CLI with npm install -g @emblemvault/agentwallet. We store no Claude app upload because the skill runs a local CLI.
Is this the official Emblem skill?
It is in EmblemCompany's own repo, which the README calls the official skill collection for EmblemAI. SKILL.md metadata names EmblemAI as author.
Does it work with Bitcoin?
Only for balances and as a bridge target through ChangeNow. SKILL.md says Bitcoin has balance support but no on-chain swap tools.
Is it safe?
It can move real funds, so treat it with care. It runs a global npm CLI that stores wallet credentials under ~/.emblemai and can create a new wallet on first use in agent mode. Our advice: start with quotes and small amounts, and stay at the keyboard for every swap.
What does it cost?
The skills name no fees. Network fees and any bridge fees come from the chains and ChangeNow. The agent-wallet skill documents pay-as-you-go billing commands for the CLI, without prices, so check the Emblem docs.
Information
updated Nov 2, 2026
- Repository
- emblemcompany/agent-skills
- Folder
skills/emblem-token-swap
Sources
Docs, issue trackers and discussions this page is built from.
Show all 5Hide
- README · github.com
- emblem-token-swap SKILL.md · github.com
- agent-wallet commands.md · github.com
- emblem-ai-agent-wallet SKILL.md · github.com
- agent-wallet security.md · github.com