PlugWiki

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

  1. What This Skill Can Do
  2. Notes
  3. Quick Start
  4. Workflow: Safe Token Swap
  5. Step 1: Check Balance
  6. Step 2: Get a Quote
  7. Step 3: Execute the Swap
  8. Step 4: Verify
  9. Swap Patterns
  10. Solana Swaps
  11. EVM Swaps
  12. Hedera Swaps
  13. Cross-Chain Bridge
  14. Communication Rules
  15. Safety
  16. Helper Script

Key facts

Installs on skills.sh
8,595 as of 2026-11-02
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 · splBuyIntent

  • Quotes 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 ethSwap

  • Quotes and swaps on Hedera

    Quote first, then execute.

    Runs code · hederaTokensSwapQuote and hederaTokensSwap

  • Cross-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 swapUsingChangeNow

  • Check 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 tools

  • Balance, quote, execute, verify

    Four steps. SKILL.md says safe mode asks for your confirmation before the execute step.

    Runs code · Safe swap workflow

  • Prints 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-onlyNo read-only mode. SKILL.md has a quote step before the execute step, but it defines no switch that blocks execution.
Talks toEmblemVault service, through the emblemai CLI. ChangeNow for cross-chain bridges
Sign-in and keysThe emblemai CLI stores an encrypted password, a key file and a session file under ~/.emblemai/profiles/<name>, per the agent-wallet security notes.
Scopes
  • Claude runs emblemai commands in your shell, which talk to the EmblemVault service

  • The CLI keeps a profile and session under ~/.emblemai

  • Swap and bridge tools can send transactions from your wallet

  • swap-helper.sh runs a balance prompt for all chains

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

Folder
skills/emblem-token-swap

emblemcompany/agent-skillsskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 5
  1. README · github.com
  2. emblem-token-swap SKILL.md · github.com
  3. agent-wallet commands.md · github.com
  4. emblem-ai-agent-wallet SKILL.md · github.com
  5. agent-wallet security.md · github.com

Updated Nov 2, 2026.