{"id":"8694bf5c-eb0b-4d27-8497-c773e5417cf9","shortId":"3DwE4x","kind":"skill","title":"emblem-token-swap","tagline":"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.","description":"# Emblem Token Swap\n\nGuided token swapping powered by **EmblemAI**. Swap tokens on Solana, Ethereum, Base, BSC, Polygon, and Hedera with automatic routing. Cross-chain bridging via ChangeNow.\n\n**Requires**: `npm install -g @emblemvault/agentwallet`\n\n---\n\n## What This Skill Can Do\n\n| Chain | Quote Tool | Swap Tool | Balance Tool | Token Search |\n|-------|-----------|-----------|-------------|--------------|\n| Solana | `splBuyIntent` (quote mode) | `splBuyIntent` (swap mode) | `solanaBalances` | `findSolanaSwapToken` |\n| Ethereum | `ethSwapQuote` | `ethSwap` | `ethGetBalances` | `searchCryptoByName` |\n| Base | `baseSwapQuote` | `baseSwap` | `baseGetBalances` | `searchEvmTokensBirdeye` |\n| BSC | `bscSwapQuote` | `bscSwap` | `bscGetBalances` | `searchEvmTokensBirdeye` |\n| Polygon | `polygonSwapQuote` | `polygonSwap` | `polygonGetBalances` | `searchEvmTokensBirdeye` |\n| Hedera | `hederaTokensSwapQuote` | `hederaTokensSwap` | `hederaGetBalances` | `hederaFindTokens` |\n| Cross-chain | `getChangeNowSwapQuote` | `swapUsingChangeNow` | — | `getChangeNowSupportedCurrencies` |\n\n### Notes\n\n- **Solana** uses `splBuyIntent` for both quotes and execution — it handles token lookup by name/symbol/CA and flexible amounts ($USD, SOL, or token quantity)\n- **EVM chains** (Ethereum, Base, BSC, Polygon) route through automatic DEX aggregation\n- **Cross-chain** bridges via ChangeNow support 500+ currencies\n- Bitcoin has balance support (`getBTCBalances`) but no on-chain swap tools — use ChangeNow for BTC bridges\n\n---\n\n## Quick Start\n\n```bash\nnpm install -g @emblemvault/agentwallet\n\n# Solana swap (uses splBuyIntent)\nemblemai --agent --profile default -m \"Use splBuyIntent to swap 5 SOL for USDC on Solana\"\n\n# Cross-chain bridge (uses ChangeNow)\nemblemai --agent --profile default -m \"Use getChangeNowSwapQuote to get a quote for bridging 0.05 ETH from Ethereum to SOL on Solana\"\n```\n\n**Trigger phrases:**\n- \"Swap SOL to USDC\"\n- \"Exchange ETH for USDT\"\n- \"Convert my tokens\"\n- \"Bridge tokens to Base\"\n\n---\n\n## Workflow: Safe Token Swap\n\n### Step 1: Check Balance\nConfirm you have enough of the source token.\n```bash\nemblemai --agent --profile default -m \"Use solanaBalances to show my Solana token balances\"\n```\n\n### Step 2: Get a Quote\nPreview the swap before executing.\n```bash\nemblemai --agent --profile default -m \"Use splBuyIntent to get a quote for swapping 5 SOL to USDC\"\n```\n\n### Step 3: Execute the Swap\n```bash\nemblemai --agent --profile default -m \"Use splBuyIntent to swap 5 SOL for USDC on Solana\"\n```\nSafe mode requires your confirmation before executing.\n\n### Step 4: Verify\nConfirm the new balance.\n```bash\nemblemai --agent --profile default -m \"Use solanaBalances to show my updated balances\"\n```\n\n---\n\n## Swap Patterns\n\n### Solana Swaps\n```bash\n# By token amount\nemblemai --agent --profile default -m \"Use splBuyIntent to swap 0.5 SOL for USDC\"\n\n# By dollar amount\nemblemai --agent --profile default -m \"Use splBuyIntent to swap $20 of SOL for JUP\"\n\n# By token name\nemblemai --agent --profile default -m \"Use splBuyIntent to swap 100 USDC for BONK\"\n```\n\n### EVM Swaps\n```bash\n# Ethereum\nemblemai --agent --profile default -m \"Use ethSwapQuote to get a quote for swapping 0.01 ETH to USDC, then use ethSwap to execute\"\n\n# Base\nemblemai --agent --profile default -m \"Use baseSwapQuote to quote 0.005 ETH to USDC on Base\"\n\n# BSC\nemblemai --agent --profile default -m \"Use bscSwapQuote to quote 0.1 BNB to USDT on BSC\"\n\n# Polygon\nemblemai --agent --profile default -m \"Use polygonSwapQuote to quote 10 POL to USDC on Polygon\"\n```\n\n### Hedera Swaps\n```bash\nemblemai --agent --profile default -m \"Use hederaTokensSwapQuote to get a quote for 100 HBAR to USDC, then use hederaTokensSwap to execute\"\n```\n\n### Cross-Chain Bridge\n```bash\nemblemai --agent --profile default -m \"Use getChangeNowSwapQuote to quote bridging 0.1 ETH to SOL\"\nemblemai --agent --profile default -m \"Use getChangeNowSupportedCurrencies to show available bridge currencies\"\n```\n\n---\n\n## Communication Rules\n\n**Always include these in swap requests:**\n1. **Tool name** — specify the exact tool for reliable routing\n2. **Amount** — dollar value or token quantity\n3. **Source token** — what you're swapping from\n4. **Target token** — what you're swapping to\n\n| Bad | Good |\n|-----|------|\n| `\"swap sol usdc\"` | `\"Use splBuyIntent to swap 5 SOL for USDC\"` |\n| `\"buy eth\"` | `\"Use ethSwap to swap 100 USDC to ETH on Ethereum\"` |\n| `\"bridge\"` | `\"Use getChangeNowSwapQuote to bridge 0.05 ETH to SOL\"` |\n\n---\n\n## Safety\n\nAll swaps require explicit user confirmation (safe mode). The agent will:\n1. Show you the swap details (amount, route, estimated output)\n2. Wait for your approval before executing\n3. Report the transaction result\n\nNever bypasses confirmation for any value-moving operation.\n\n---\n\n## Helper Script\n\n```bash\nbash scripts/swap-helper.sh\n```\n\nSee [scripts/swap-helper.sh](scripts/swap-helper.sh) for an interactive swap walkthrough.\n\n---\n\n## Links\n\n- [Agent Wallet CLI](https://www.npmjs.com/package/@emblemvault/agentwallet)\n- [EmblemVault Docs — canonical](https://emblemvault.ai/docs)\n- [EmblemVault Docs — interactive](https://emblemvault.dev)","tags":["emblem","token","swap","agent","skills","emblemcompany","agent-skills","ai-agent","blockchain","cross-chain","crypto","defi"],"capabilities":["skill","source-emblemcompany","skill-emblem-token-swap","topic-agent-skills","topic-ai-agent","topic-blockchain","topic-cross-chain","topic-crypto","topic-defi","topic-emblem","topic-emblemai","topic-ethereum","topic-nft","topic-solana","topic-wallet"],"categories":["Agent-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/EmblemCompany/Agent-skills/emblem-token-swap","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add EmblemCompany/Agent-skills","source_repo":"https://github.com/EmblemCompany/Agent-skills","install_from":"skills.sh"}},"qualityScore":"0.455","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 10 github stars · SKILL.md body (5,141 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:08:25.436Z","embedding":null,"createdAt":"2026-04-23T13:04:16.845Z","updatedAt":"2026-05-18T19:08:25.436Z","lastSeenAt":"2026-05-18T19:08:25.436Z","tsv":"'/docs)':691 '/package/@emblemvault/agentwallet)':685 '0.005':455 '0.01':436 '0.05':234,619 '0.1':471,532 '0.5':382 '1':264,556,635 '10':487 '100':415,508,608 '2':290,566,645 '20':398 '3':318,573,652 '4':346,581 '5':209,313,332,598 '500':170 '6':9 'across':8 'agent':201,222,277,301,324,354,374,390,407,424,447,463,479,497,523,537,633,680 'aggreg':162 'alway':550 'amount':146,372,388,567,641 'approv':649 'asset':38 'automat':13,62,160 'avail':545 'bad':589 'balanc':85,174,266,288,351,364 'base':56,103,155,258,445,460 'basegetbal':106 'baseswap':105 'baseswapquot':104,452 'bash':191,275,299,322,352,369,421,495,521,668,669 'bitcoin':172 'blockchain':10 'bnb':472 'bonk':418 'bridg':20,37,67,166,188,218,233,255,520,531,546,614,618 'bsc':57,108,156,461,476 'bscgetbal':111 'bscswap':110 'bscswapquot':109,468 'btc':187 'buy':602 'bypass':658 'canon':688 'chain':19,41,66,80,125,153,165,181,217,519 'changenow':22,69,168,185,220 'check':265 'cli':682 'communic':548 'confirm':267,342,348,629,659 'convert':33,252 'cross':18,40,65,124,164,216,518 'cross-chain':17,39,64,123,163,215,517 'crypto':32 'currenc':35,171,547 'default':203,224,279,303,326,356,376,392,409,426,449,465,481,499,525,539 'detail':640 'dex':161 'doc':687,693 'dollar':387,568 'emblem':2,42 'emblem-token-swap':1 'emblemai':12,50,200,221,276,300,323,353,373,389,406,423,446,462,478,496,522,536 'emblemvault':686,692 'emblemvault.ai':690 'emblemvault.ai/docs)':689 'emblemvault.dev':695 'emblemvault/agentwallet':74,195 'enough':270 'estim':643 'eth':235,249,437,456,533,603,611,620 'ethereum':55,98,154,237,422,613 'ethgetbal':101 'ethswap':100,442,605 'ethswapquot':99,429 'evm':152,419 'exact':561 'exchang':31,248 'execut':5,137,298,319,344,444,516,651 'explicit':627 'findsolanaswaptoken':97 'flexibl':145 'g':73,194 'get':229,291,308,431,504 'getbtcbal':176 'getchangenowsupportedcurr':128,542 'getchangenowswapquot':126,227,528,616 'good':590 'guid':45 'handl':139 'hbar':509 'hedera':60,118,493 'hederafindtoken':122 'hederagetbal':121 'hederatokensswap':120,514 'hederatokensswapquot':119,502 'helper':666 'includ':551 'instal':72,193 'interact':676,694 'jup':402 'link':679 'lookup':141 'm':204,225,280,304,327,357,377,393,410,427,450,466,482,500,526,540 'mode':92,95,339,631 'move':664 'name':405,558 'name/symbol/ca':143 'never':657 'new':350 'note':129 'npm':71,192 'on-chain':179 'oper':665 'optim':15 'output':644 'pattern':366 'phrase':243 'pol':488 'polygon':58,113,157,477,492 'polygongetbal':116 'polygonswap':115 'polygonswapquot':114,484 'power':48 'preview':294 'profil':202,223,278,302,325,355,375,391,408,425,448,464,480,498,524,538 'quantiti':151,572 'quick':189 'quot':81,91,135,231,293,310,433,454,470,486,506,530 're':578,586 'reliabl':564 'report':653 'request':555 'requir':70,340,626 'result':656 'rout':14,63,158,565,642 'rule':549 'safe':260,338,630 'safeti':623 'script':667 'scripts/swap-helper.sh':670,672,673 'search':88 'searchcryptobynam':102 'searchevmtokensbirdey':107,112,117 'see':671 'show':284,361,544,636 'skill':77 'skill-emblem-token-swap' 'sol':148,210,239,245,314,333,383,400,535,592,599,622 'solana':54,89,130,196,214,241,286,337,367 'solanabal':96,282,359 'sourc':273,574 'source-emblemcompany' 'specifi':559 'splbuyint':90,93,132,199,206,306,329,379,395,412,595 'start':190 'step':263,289,317,345 'support':169,175 'swap':4,7,29,44,47,51,83,94,182,197,208,244,262,296,312,321,331,365,368,381,397,414,420,435,494,554,579,587,591,597,607,625,639,677 'swapusingchangenow':127 'target':582 'token':3,6,30,43,46,52,87,140,150,254,256,261,274,287,371,404,571,575,583 'tool':82,84,86,183,557,562 'topic-agent-skills' 'topic-ai-agent' 'topic-blockchain' 'topic-cross-chain' 'topic-crypto' 'topic-defi' 'topic-emblem' 'topic-emblemai' 'topic-ethereum' 'topic-nft' 'topic-solana' 'topic-wallet' 'transact':655 'trigger':242 'updat':363 'usd':147 'usdc':212,247,316,335,385,416,439,458,490,511,593,601,609 'usdt':251,474 'use':23,131,184,198,205,219,226,281,305,328,358,378,394,411,428,441,451,467,483,501,513,527,541,594,604,615 'user':26,628 'valu':569,663 'value-mov':662 'verifi':347 'via':11,21,68,167 'wait':646 'walkthrough':678 'wallet':681 'want':27 'workflow':259 'www.npmjs.com':684 'www.npmjs.com/package/@emblemvault/agentwallet)':683","prices":[{"id":"b9cfab06-c97e-49d7-b45d-46a483c87bd9","listingId":"8694bf5c-eb0b-4d27-8497-c773e5417cf9","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"EmblemCompany","category":"Agent-skills","install_from":"skills.sh"},"createdAt":"2026-04-23T13:04:16.845Z"}],"sources":[{"listingId":"8694bf5c-eb0b-4d27-8497-c773e5417cf9","source":"github","sourceId":"EmblemCompany/Agent-skills/emblem-token-swap","sourceUrl":"https://github.com/EmblemCompany/Agent-skills/tree/main/skills/emblem-token-swap","isPrimary":false,"firstSeenAt":"2026-04-23T13:04:16.845Z","lastSeenAt":"2026-05-18T19:08:25.436Z"}],"details":{"listingId":"8694bf5c-eb0b-4d27-8497-c773e5417cf9","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"EmblemCompany","slug":"emblem-token-swap","github":{"repo":"EmblemCompany/Agent-skills","stars":10,"topics":["agent-skills","ai-agent","blockchain","cross-chain","crypto","defi","emblem","emblemai","ethereum","nft","solana","wallet","web3"],"license":"mit","html_url":"https://github.com/EmblemCompany/Agent-skills","pushed_at":"2026-05-15T08:53:47Z","description":"Official skill collection for EmblemAI agents — 200+ crypto tools across 7 blockchains","skill_md_sha":"22e239e5c287d3036e5cfec3a9945dc0f3c2fe30","skill_md_path":"skills/emblem-token-swap/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/EmblemCompany/Agent-skills/tree/main/skills/emblem-token-swap"},"layout":"multi","source":"github","category":"Agent-skills","frontmatter":{"name":"emblem-token-swap","license":"MIT","description":"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.","compatibility":"Requires Node.js >= 18.0.0, @emblemvault/agentwallet CLI, and internet access. Works on Claude Code, Cursor, Codex, OpenClaw, and other agents following the Agent Skills spec."},"skills_sh_url":"https://skills.sh/EmblemCompany/Agent-skills/emblem-token-swap"},"updatedAt":"2026-05-18T19:08:25.436Z"}}