[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M76ZGT55AVKNW2DXTVTHXT6V":3,"skill-same:01M76ZGT55AVKNW2DXTVTHXT6V":64},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":41,"commitSha":42,"skillDirectory":43,"forksCount":44,"repositoryHtmlUrl":45,"repositoryHomepageUrl":46,"ownerHtmlUrl":47,"ownerBlogUrl":6,"ownerDescription":48,"updatedAt":49,"install":50,"resources":63},"01M76ZGT55AVKNW2DXTVTHXT6V","atxswap",null,"Manage ATX on BSC with wallet creation, price and balance queries, PancakeSwap V3 swaps, liquidity operations, LP positions and holdings, and BNB\u002FERC20 transfers. Use when the user mentions ATX, BSC, PancakeSwap V3, wallet creation, price checks, buying, selling, liquidity, fees, holdings, LP positions, or token transfers.","Lord1Egypt\u002Fawesome-skill-forge","Lord1Egypt","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F99746359?v=4","01M7592YDNT0XK9WJ0T2MQVPDN","Mohamed Mounir Ali AL Keshita","01M75GRFNHC8VZNWEB8DKDE433",3,"MIT","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Fa\u002Fatxswap\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: atxswap\ndescription: >-\n  Manage ATX on BSC with wallet creation, price and balance queries, PancakeSwap\n  V3 swaps, liquidity operations, LP positions and holdings, and BNB\u002FERC20 transfers.\n  Use when the user mentions ATX, BSC, PancakeSwap V3, wallet creation, price checks,\n  buying, selling, liquidity, fees, holdings, LP positions, or token transfers.\nversion: \"0.0.31\"\ncompatibility: Requires Node.js 18+ and npm. Network access to BSC RPC required.\ninject:\n  - bash: echo \"${CLAUDE_SKILL_DIR:-$(cd \"$(dirname \"$0\")\u002F..\" && pwd)}\"\n    as: SKILL_DIR\nmetadata:\n  author: agentswapx\n  openclaw:\n    requires:\n      bins:\n        - node\n        - npm\n    homepage: https:\u002F\u002Fgithub.com\u002Fagentswapx\u002Fskills\u002Ftree\u002Fmain\u002Fatxswap\n    os:\n      - linux\n      - macos\n---\n\n# ATXSwap Skill\n\nExecute ATX trading and wallet workflows on BSC. This skill is designed for\nagents that need safe, repeatable commands for wallet management, ATX\u002FUSDT\nquotes, swaps, V3 liquidity actions, and transfers.\n\n- **SDK**: [`atxswap-sdk`](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fatxswap-sdk) on npm ([source](https:\u002F\u002Fgithub.com\u002Fagentswapx\u002Fatxswap-sdk))\n- **Docs (team \u002F project)**: [Team introduction (EN)](https:\u002F\u002Fdocs.atxswap.com\u002Fguide\u002Fteam) · [Team introduction (ZH)](https:\u002F\u002Fdocs.atxswap.com\u002Fzh\u002Fguide\u002Fteam)\n- **Keystore dir**: `~\u002F.config\u002Fatxswap\u002Fkeystore` (fixed, not configurable)\n- **Secrets dir**: `~\u002F.config\u002Fatxswap\u002F` (master.key + secrets.json)\n\n## Use This Skill For\n\n- Create the single wallet used by this skill instance (importing an existing private key is not supported)\n- Query ATX price, balances, LP positions (see **Required agent reply for holdings** under `query.js`), quotes, and arbitrary ERC20 token info\n- Buy or sell ATX against USDT on PancakeSwap V3\n- Add liquidity (full range or a custom **price range in USDT per ATX** or **tick** bounds), remove liquidity, collect fees, or burn empty LP NFTs\n- Transfer BNB, ATX, USDT, or arbitrary ERC20 tokens\n\n## Before First Use\n\nThis skill ships its own Node scripts and depends on `atxswap-sdk`.\n\n1. Open the skill directory where this `SKILL.md` is installed.\n2. Run `npm install` there before using any script.\n3. If `npm install` fails, stop and report the dependency error instead of guessing.\n\nIf the skill is installed via ClawHub or OpenClaw CLI, the install location is\ntypically `~\u002F.clawhub\u002Fskills\u002Fatxswap\u002F` (or the equivalent client-managed path).\nIf you cloned this repository directly, the location is `skills\u002Fatxswap\u002F`.\n\n## Script Location\n\nUse the skill directory path to locate scripts. If `${SKILL_DIR}` is available\n(injected by skills.sh-compatible runtimes), use it; otherwise use the absolute\npath to this skill's installed directory.\n\nExample:\n\n```bash\ncd skills\u002Fatxswap && npm install\ncd \"${SKILL_DIR}\" && node scripts\u002Fwallet.js list\n```\n\nAll examples below use `cd \"${SKILL_DIR}\" &&` for clarity. If your runtime does\nnot inject `${SKILL_DIR}`, replace it with the absolute path of the installed\nskill directory.\n\n## Runtime Notes\n\n- `BSC_RPC_URL` is optional and supports comma-separated values for fallback,\n  e.g. `BSC_RPC_URL=\"https:\u002F\u002Fprimary,https:\u002F\u002Fbackup1,https:\u002F\u002Fbackup2\"`. When\n  unset, scripts use a built-in fallback list of 6 BSC public RPC endpoints\n  and viem will retry them in order.\n- Wallet files live under `~\u002F.config\u002Fatxswap\u002Fkeystore`.\n- Secure secrets live under `~\u002F.config\u002Fatxswap\u002F` (master.key + secrets.json).\n- Only **one wallet** is allowed per skill installation. If a wallet already\n  exists, `wallet.js create` fails.\n- Use `wallet.js list` before creating a wallet.\n- Importing an existing private key via this skill is **not supported**. If the\n  user asks to import a private key, refuse and tell them to use a dedicated\n  wallet tool of their choice.\n- Scripts write JSON output. `wallet.js export` prints the address's\n  encrypted **MetaMask-compatible keystore V3 JSON** to stdout (or writes it\n  to a file via `--out \u003Cfile>`); it never prints the raw private key.\n- `query.js quote` can return a JSON error if the configured Quoter or RPC\n  rejects the simulation. Surface the error and do not proceed to a write.\n- For balance, holdings, LP position, or pending-fee questions, always fetch\n  fresh on-chain data at request time. Do **NOT** answer from prior chat\n  output, memory, cached numbers, or earlier command results unless you rerun\n  the relevant query first.\n- For custom-range liquidity, do **not** guess the second token amount from chat.\n  First run `liquidity.js quote-add` or use `liquidity.js add --base-token ... --amount ...`\n  so the script computes the counter-asset from the live pool price and range.\n\n## Password Rules\n\nWhen the user asks to **create** a wallet:\n\n1. Ask the user for a password first (do NOT generate one).\n2. Pass it via `--password \u003Cpwd>` to the script when running non-interactively.\n3. The password is auto-saved to secure storage after creation.\n4. Never print the password back to the chat.\n5. After the wallet is created, export and send the encrypted keystore backup to\n   the user who requested the wallet.\n6. Clearly label it as encrypted keystore backup material, not the raw private key.\n7. Do not upload it to any website or send it to any third party.\n\nFor **swap**, **transfer**, and **liquidity** operations, rely on auto-unlock\nfirst. Only ask for the password if auto-unlock fails.\n\nIf the user says they forgot the wallet password or asks to recover it, first\nexplain that saved wallet passwords are encrypted at rest in the local\nSecretStore (for example Keychain, Secret Service, or the file backend under\n`~\u002F.config\u002Fatxswap\u002F`) and are not stored by the agent in chat memory. Even if\nthe user confirms, do **not** print the password in chat; guide them to use a\ntrusted local workflow instead.\n\n## Hard Safety Rules\n\n1. Treat all BSC writes as real-asset operations.\n2. **NEVER** output private keys or passwords in chat.\n3. **ALWAYS** run a preview before write actions: query price, quote, balance,\n   or positions as appropriate.\n4. **ALWAYS** show the preview to the user and wait for explicit confirmation\n   before swap, transfer, or liquidity writes.\n5. **NEVER** execute large trades without the user saying \"yes\" or \"confirm\".\n6. `wallet.js export` only emits the **encrypted MetaMask-compatible keystore\n   JSON**, never the raw private key. There is no command that prints the\n   unencrypted private key, and the agent must not attempt to derive or display\n   one.\n7. Prefer `wallet.js export \u003Caddress> --out \u003Cfile>` and tell the user the file\n   path. Avoid pasting the keystore JSON itself into chat unless the user\n   explicitly asks for it.\n8. Before deleting a wallet, keystore file, or any private-key-bearing wallet\n   material, **ALWAYS** remind the user to export and back up the encrypted\n   keystore first. Do not delete anything until the user explicitly confirms\n   that the keystore backup has been completed.\n9. Wallet deletion requires a second explicit confirmation: after backup is\n   confirmed, require the user to send the exact phrase `force delete wallet` before\n   running any delete command.\n10. If the user asks to delete a wallet, do **NOT** send the keystore\n    immediately. First ask whether they want to receive the encrypted keystore\n    backup. Only after the user agrees may you export and send the keystore to\n    the user.\n11. If the user explicitly asks to back up or export the wallet, export and\n    send the encrypted keystore backup to the user who requested the wallet,\n    and clearly label it as keystore backup material.\n12. The encrypted keystore may only be sent to the user who owns the current\n    session request. **NEVER** send the keystore through any channel that is not\n    under that user's own control.\n    It may only be sent to the user personally, and must not be pasted into any\n    external form or sent to any other person, group, agent, or service.\n13. After `wallet.js create` succeeds, export and send the encrypted keystore\n    to the user who requested the wallet. Treat this as part of the wallet\n    creation handoff, but only to that user.\n14. If the user asks to recover or reveal a saved wallet password, remind them\n   that the password is encrypted in local secure storage and must not be\n   disclosed in chat. Do not attempt to print, derive, or expose the password\n   even after user confirmation.\n15. If the user asks to recover, reveal, print, or paste the wallet private key,\n    refuse. Offer `wallet.js export \u003Caddress> --out \u003Cfile>` as the only\n    supported backup path, because it exports an encrypted keystore instead of\n    exposing the raw private key.\n16. For every transfer, treat the tuple `(asset, from, to, amount)` as a single\n    transfer intent. Repeat that exact tuple back to the user before execution.\n17. After a transfer command returns a `txHash`, consider that transfer intent\n    **already sent**. Do **NOT** send the same transfer again unless the user\n    explicitly asks to send it again.\n18. If a transfer write ends in an ambiguous state (for example RPC timeout,\n    dropped connection, or partial output after signing\u002Fsubmission), do **NOT**\n    retry blindly. First check chain state or wallet state, summarize what is\n    known, and ask the user whether to retry.\n19. If the same transfer tuple appears again in the same conversation after a\n    successful or ambiguous prior attempt, pause and ask whether the user means\n    a new transfer or is referring to the earlier one.\n20. For any user question about **current** balances, holdings, LP positions,\n    pending fees, or wallet assets, rerun the matching read command against the\n    chain first. Never rely on previously displayed numbers as if they were\n    still current.\n\n## Required Preview Flow\n\nBefore every write action:\n\n1. Query the price, quote, balance, or positions that match the requested action.\n2. Summarize the preview in plain language.\n3. Ask the user to confirm.\n4. Execute the write command only after confirmation.\n5. Return the transaction hash and the key result fields.\n\nFor transfers, the summary in step 2 must explicitly include:\n\n- asset\n- source wallet\n- destination address\n- amount\n\nAfter step 5, if a `txHash` is available, treat the transfer as executed and do\nnot issue the same write again unless the user clearly requests a second send.\n\nFor read-only asset questions:\n\n1. Run the relevant live query first (`query.js balance`, `query.js positions`,\n   `query.js price`, or `query.js quote` as appropriate).\n2. Answer from that fresh output only.\n3. If the RPC or query fails, say the data could not be refreshed instead of\n   reusing older numbers.\n\n## High-Value Workflows\n\n### Check market state\n\n```bash\ncd \"${SKILL_DIR}\" && node scripts\u002Fquery.js price\ncd \"${SKILL_DIR}\" && node scripts\u002Fquery.js balance \u003Caddress>\ncd \"${SKILL_DIR}\" && node scripts\u002Fquery.js positions \u003Caddress>\ncd \"${SKILL_DIR}\" && node scripts\u002Fquery.js positions \u003Caddress> \u003CtokenId>\n```\n\n### Preview before swap\n\n```bash\ncd \"${SKILL_DIR}\" && node scripts\u002Fquery.js quote \u003Cbuy|sell> \u003Camount>\n```\n\n### Execute after confirmation\n\n```bash\ncd \"${SKILL_DIR}\" && node scripts\u002Fswap.js buy \u003CusdtAmount> [--from address] [--slippage bps] [--password \u003Cpwd>]\ncd \"${SKILL_DIR}\" && node scripts\u002Fliquidity.js add \u003CatxAmount> \u003CusdtAmount> [range opts] [--from address] [--slippage-bps n] [--password \u003Cpwd>]\ncd \"${SKILL_DIR}\" && node scripts\u002Fliquidity.js add --base-token \u003Catx|usdt> --amount \u003Cn> [range opts] [--from address] [--slippage-bps n] [--password \u003Cpwd>]\ncd \"${SKILL_DIR}\" && node scripts\u002Ftransfer.js atx \u003Cto> \u003Camount> [--from address] [--password \u003Cpwd>]\n```\n\n## Command Reference\n\n### `wallet.js`\n\n```bash\ncd \"${SKILL_DIR}\" && node scripts\u002Fwallet.js create [name] --password \u003Cpwd>\ncd \"${SKILL_DIR}\" && node scripts\u002Fwallet.js list\ncd \"${SKILL_DIR}\" && node scripts\u002Fwallet.js export \u003Caddress> [--out \u003Cfile>]\ncd \"${SKILL_DIR}\" && node scripts\u002Fwallet.js has-password \u003Caddress>\ncd \"${SKILL_DIR}\" && node scripts\u002Fwallet.js forget-password \u003Caddress>\ncd \"${SKILL_DIR}\" && node scripts\u002Fwallet.js delete \u003Caddress> --backup-confirmed yes --force-phrase \"force delete wallet\"\n```\n\nAfter `wallet.js create`:\n\n1. Return the created wallet address.\n2. Run `wallet.js export \u003Caddress> [--out \u003Cfile>]`.\n3. Send the encrypted keystore only to the user who requested the wallet.\n4. Do not upload it to any website or send it to any third party.\n5. Explain that it is encrypted keystore backup material, not the raw private key.\n\nBefore `wallet.js delete`:\n\n1. Ask whether the user wants the encrypted keystore sent to them for backup.\n2. After the user agrees, export and send the encrypted keystore to the user only.\n3. Do not upload it to any website or send it to any third party.\n4. Require the user to explicitly confirm that the backup is complete.\n5. Require the user to send the exact phrase `force delete wallet`.\n6. Only then run `wallet.js delete \u003Caddress> --backup-confirmed yes --force-phrase \"force delete wallet\"`.\n\nIf the user asks to back up the wallet:\n\n1. Run `wallet.js export \u003Caddress> [--out \u003Cfile>]`.\n2. Send the encrypted keystore only to the user.\n3. Do not upload it to any website or send it to any third party.\n4. Explain that this is encrypted keystore backup material, not the raw private key.\n\n### `query.js`\n\n```bash\ncd \"${SKILL_DIR}\" && node scripts\u002Fquery.js price\ncd \"${SKILL_DIR}\" && node scripts\u002Fquery.js balance \u003Caddress>\ncd \"${SKILL_DIR}\" && node scripts\u002Fquery.js quote \u003Cbuy|sell> \u003Camount>\ncd \"${SKILL_DIR}\" && node scripts\u002Fquery.js positions \u003Caddress>\ncd \"${SKILL_DIR}\" && node scripts\u002Fquery.js positions \u003Caddress> \u003CtokenId>\ncd \"${SKILL_DIR}\" && node scripts\u002Fquery.js token-info \u003CtokenAddress>\n```\n\n`query.js positions` includes **principal token amounts** in the position (`principalAtx`,\n`principalUsdt`, `principal0`, `principal1`) computed from V3 `liquidity` (L), ticks (internal),\nand the pool’s current `sqrtPriceX96` (same `getAmountsForLiquidity` math as the web app). It emits\nhuman **USDT-per-ATX** bounds as **`priceRangeUsdtPerAtx.min` \u002F `.max`**, **`currentPriceUsdtPerAtx`**,\nand **`currentPriceInRange`** (whether the pool tick lies inside that position). It includes\n**`pendingFees.atx`** and **`pendingFees.usdt`** as the simulated collect notionals (`collectable*`),\nplus raw `tokensOwed0`\u002F`1` and `collectable0`\u002F`1` for debugging. Use `collectable*` \u002F `pendingFees`\nto decide whether a fee harvest is worth executing. Each object also includes **`feePercent`**\n(e.g. `\"0.25%\"`) for the pool’s swap-fee tier; raw **`fee`** stays the on-chain code\n(`100` \u002F `500` \u002F `2500` \u002F `10000`). **Tick indices are not included** in the JSON — quote\nUSDT\u002FATX prices and in-range state instead.\n\nWhen the user asks \"how much do I have now\", \"what is my current balance\", \"what\npositions are left\", \"how much ATX is still in the LP\", or similar present-tense\nquestions, rerun `query.js balance` and\u002For `query.js positions` immediately.\nDo not answer from previously captured JSON.\n\n**Required agent reply for holdings** when the user asks about their positions, LP NFTs, or liquidity holdings (per position):\n\nRun `query.js positions \u003Caddress>` (omit `tokenId` to list all ATX\u002FUSDT V3 NFTs). The CLI prints\n**one JSON object per NFT**; include **every** position. For each position, the answer **must**\naddress the topics below (label them in the user’s language when replying). **Do not** show raw\nV3 tick numbers to the user — use **USDT per 1 ATX** from the JSON below.\n\n| Topic | What to include | CLI JSON fields |\n|-------|-----------------|-----------------|\n| **Tokens in the position** | **In-range liquidity** as ATX and USDT notionals — always cite **`principalAtx`** and **`principalUsdt`** (and optionally `principal0` \u002F `principal1` in pool token0\u002Ftoken1 order). These are computed at the **current pool price**. Mention `liquidity` only as the raw **L** scalar if explaining detail. Do **not** treat **`query.js balance`** as LP “position tokens”: wallet ATX\u002FUSDT\u002FBNB balances are unrelated to NFT principal — if shown, label them distinctly (e.g. “Wallet balances, separate from this LP NFT”). |\n| **NFT token ID** | The V3 LP NFT id | `tokenId` |\n| **Pool swap fee tier** | The pool’s trading fee as a **percentage** for end users | Prefer **`feePercent`** (e.g. `\"0.25%\"`). If you show the raw tier code, pair it with **`feePercent`** (e.g. `2500` + `0.25%`). |\n| **Price range & spot** | Configured **min\u002Fmax USDT per 1 ATX** for the position, and current pool price in the same unit | **`priceRangeUsdtPerAtx.min`**, **`priceRangeUsdtPerAtx.max`**, **`currentPriceUsdtPerAtx`**, **`currentPriceInRange`** (confirm “in range” \u002F “out of range” in natural language). |\n| **Pending fees** | Uncollected fees (both tokens) | Always show **`pendingFees.atx`** and **`pendingFees.usdt`** explicitly. Prefer these over quoting only one asset. Optionally reference `collectableAtx`\u002F`collectableUsdt` synonyms. State fees stay **pending** until `liquidity.js collect`. |\n\nDo not answer with only raw pool indices (ticks). If there are no positions, relay `No ATX\u002FUSDT positions found.` exactly.\n\nMinor mismatch vs on-chain bookkeeping can occur because `principal*` uses the same float-based\ntick→√P path as other tooling (~wei-level); values are intended for humans and routing, not audits.\n\n### `swap.js`\n\n```bash\ncd \"${SKILL_DIR}\" && node scripts\u002Fswap.js buy \u003CusdtAmount> [--from address] [--slippage bps] [--password \u003Cpwd>]\ncd \"${SKILL_DIR}\" && node scripts\u002Fswap.js sell \u003CatxAmount> [--from address] [--slippage bps] [--password \u003Cpwd>]\n```\n\n### `liquidity.js`\n\n**`add` — price \u002F tick range** (same USDT\u002FATX semantics as the web app; default full range = full-width liquidity):\n\n- Default: no extra flags means **full range** (same as before).\n- `--full-range`: explicit full range (do not combine with the two groups below).\n- `--min-price` \u002F `--max-price`: band in **USDT per 1 ATX**; the script reads pool `token0` and maps to `tickLower` \u002F `tickUpper` like the app (`token1\u002Ftoken0` + `tickSpacing`). **Both** prices are required.\n- `--range-percent`: band around **current ATX price** as a percentage; e.g. `20` means about `-20%` to `+20%` of the current price.\n- `--tick-lower` \u002F `--tick-upper`: raw V3 ticks (**both** required; script uses the smaller as lower, larger as upper, clamped to valid V3 bounds).\n- `quote-add \u003Catx|usdt> \u003Camount>`: given live price and range, estimate the other leg — use before a write.\n- `add --base-token \u003Catx|usdt> --amount \u003Cn>`: single-sided notional; script computes the other leg and executes the add.\n\nOptional: `--slippage-bps` (0–10000; default from SDK).\n\n```bash\ncd \"${SKILL_DIR}\" && node scripts\u002Fliquidity.js quote-add \u003Catx|usdt> \u003Camount> [range opts]\ncd \"${SKILL_DIR}\" && node scripts\u002Fliquidity.js add \u003CatxAmount> \u003CusdtAmount> [range opts] [--from address] [--slippage-bps n] [--password \u003Cpwd>]\ncd \"${SKILL_DIR}\" && node scripts\u002Fliquidity.js add --base-token \u003Catx|usdt> --amount \u003Cn> [range opts] [--from address] [--slippage-bps n] [--password \u003Cpwd>]\ncd \"${SKILL_DIR}\" && node scripts\u002Fliquidity.js remove \u003CtokenId> \u003Cpercent> [--from address] [--password \u003Cpwd>]\ncd \"${SKILL_DIR}\" && node scripts\u002Fliquidity.js collect \u003CtokenId> [--from address] [--password \u003Cpwd>]\ncd \"${SKILL_DIR}\" && node scripts\u002Fliquidity.js burn \u003CtokenId> [--from address] [--password \u003Cpwd>]\n```\n\n`liquidity.js remove` already uses a single `multicall`:\n`decreaseLiquidity` -> `collect` -> and when `percent = 100`, `burn`.\nThat means a full removal automatically collects withdrawable funds and destroys the LP NFT in the same transaction, so\nrunning `collect` again for the same `tokenId` is expected to fail because the position no longer exists.\n\nBefore `collect`, preview the target position with:\n\n```bash\ncd \"${SKILL_DIR}\" && node scripts\u002Fquery.js positions \u003Caddress> \u003CtokenId>\n```\n\nPrefer `pendingFees` \u002F `collectableAtx` \u002F `collectableUsdt` over relying on `tokensOwed0\u002F1` alone when deciding whether\nfees are available, because the raw `tokensOwed` fields may stay at zero while\n`collect()` can still succeed.\n\nExample (not full-range; align the range with the user using `query.js price` before writes):\n\n```bash\ncd \"${SKILL_DIR}\" && node scripts\u002Fliquidity.js quote-add usdt 0.1 --range-percent 20\ncd \"${SKILL_DIR}\" && node scripts\u002Fliquidity.js add --base-token usdt --amount 0.1 --range-percent 20 --from \u003Caddress>\ncd \"${SKILL_DIR}\" && node scripts\u002Fliquidity.js add 10 1 --min-price 0.05 --max-price 0.15\ncd \"${SKILL_DIR}\" && node scripts\u002Fliquidity.js add 10 1 --tick-lower -20000 --tick-upper 1000\n```\n\nMapping user phrasing to commands:\n\n- If the user asks to add **0.1 USDT** of liquidity with a **±20%** range around spot, first run\n  `quote-add usdt 0.1 --range-percent 20`.\n- Show the returned `estimatedAmounts` (or equivalent summary) and wait for confirmation.\n- After confirmation, run\n  `add --base-token usdt --amount 0.1 --range-percent 20 --from \u003Caddress>`.\n\n### `transfer.js`\n\n```bash\ncd \"${SKILL_DIR}\" && node scripts\u002Ftransfer.js bnb \u003Cto> \u003Camount> [--from address] [--password \u003Cpwd>]\ncd \"${SKILL_DIR}\" && node scripts\u002Ftransfer.js atx \u003Cto> \u003Camount> [--from address] [--password \u003Cpwd>]\ncd \"${SKILL_DIR}\" && node scripts\u002Ftransfer.js usdt \u003Cto> \u003Camount> [--from address] [--password \u003Cpwd>]\ncd \"${SKILL_DIR}\" && node scripts\u002Ftransfer.js token \u003CtokenAddress> \u003Cto> \u003Camount> [--from address] [--password \u003Cpwd>]\n```\n\nTransfer anti-duplication checklist:\n\n1. Preview balances first.\n2. Restate the exact transfer tuple `(asset, from, to, amount)` to the user.\n3. Wait for explicit confirmation for that exact tuple.\n4. Run `transfer.js` once.\n5. Return the `txHash`.\n6. If the user repeats the same request, do not run the transfer again until\n   you clarify whether they want a second transfer.\n7. If the command may have submitted but the final result is unclear, do not\n   rerun it automatically; inspect chain state or ask the user how to proceed.\n\n## When To Refuse Or Pause\n\n- Missing wallet but the user requests a write action\n- Missing confirmation for swap, transfer, or liquidity writes\n- User asks to delete a wallet, keystore file, or private-key-bearing wallet\n  material before confirming that the encrypted keystore has been backed up\n- User asks to delete a wallet but has not agreed to receive the keystore backup first\n- User asks to delete a wallet but has not explicitly sent `force delete wallet`\n- User asks to send or upload a keystore through a channel not under their own\n  control, or to anyone other than the user\n- User asks to recover or reveal a saved wallet password in chat\n- User asks to recover, reveal, print, or paste a wallet private key in chat\n- `npm install` has not been run successfully in the skill directory\n- RPC, dependency, or wallet-unlock errors that make the state unclear\n\n## Standard Workflow\n\nFor any write action:\n\n1. Query current price, quote, balance, or positions as needed.\n2. Summarize the preview for the user.\n3. Wait for explicit confirmation.\n4. Execute the write command.\n5. Report the transaction hash and result.\n","# ATXSwap Skill\n\nExecute ATX trading and wallet workflows on BSC. This skill is designed for\nagents that need safe, repeatable commands for wallet management, ATX\u002FUSDT\nquotes, swaps, V3 liquidity actions, and transfers.\n\n- **SDK**: [`atxswap-sdk`](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fatxswap-sdk) on npm ([source](https:\u002F\u002Fgithub.com\u002Fagentswapx\u002Fatxswap-sdk))\n- **Docs (team \u002F project)**: [Team introduction (EN)](https:\u002F\u002Fdocs.atxswap.com\u002Fguide\u002Fteam) · [Team introduction (ZH)](https:\u002F\u002Fdocs.atxswap.com\u002Fzh\u002Fguide\u002Fteam)\n- **Keystore dir**: `~\u002F.config\u002Fatxswap\u002Fkeystore` (fixed, not configurable)\n- **Secrets dir**: `~\u002F.config\u002Fatxswap\u002F` (master.key + secrets.json)\n\n## Use This Skill For\n\n- Create the single wallet used by this skill instance (importing an existing private key is not supported)\n- Query ATX price, balances, LP positions (see **Required agent reply for holdings** under `query.js`), quotes, and arbitrary ERC20 token info\n- Buy or sell ATX against USDT on PancakeSwap V3\n- Add liquidity (full range or a custom **price range in USDT per ATX** or **tick** bounds), remove liquidity, collect fees, or burn empty LP NFTs\n- Transfer BNB, ATX, USDT, or arbitrary ERC20 tokens\n\n## Before First Use\n\nThis skill ships its own Node scripts and depends on `atxswap-sdk`.\n\n1. Open the skill directory where this `SKILL.md` is installed.\n2. Run `npm install` there before using any script.\n3. If `npm install` fails, stop and report the dependency error instead of guessing.\n\nIf the skill is installed via ClawHub or OpenClaw CLI, the install location is\ntypically `~\u002F.clawhub\u002Fskills\u002Fatxswap\u002F` (or the equivalent client-managed path).\nIf you cloned this repository directly, the location is `skills\u002Fatxswap\u002F`.\n\n## Script Location\n\nUse the skill directory path to locate scripts. If `${SKILL_DIR}` is available\n(injected by skills.sh-compatible runtimes), use it; otherwise use the absolute\npath to this skill's installed directory.\n\nExample:\n\n```bash\ncd skills\u002Fatxswap && npm install\ncd \"${SKILL_DIR}\" && node scripts\u002Fwallet.js list\n```\n\nAll examples below use `cd \"${SKILL_DIR}\" &&` for clarity. If your runtime does\nnot inject `${SKILL_DIR}`, replace it with the absolute path of the installed\nskill directory.\n\n## Runtime Notes\n\n- `BSC_RPC_URL` is optional and supports comma-separated values for fallback,\n  e.g. `BSC_RPC_URL=\"https:\u002F\u002Fprimary,https:\u002F\u002Fbackup1,https:\u002F\u002Fbackup2\"`. When\n  unset, scripts use a built-in fallback list of 6 BSC public RPC endpoints\n  and viem will retry them in order.\n- Wallet files live under `~\u002F.config\u002Fatxswap\u002Fkeystore`.\n- Secure secrets live under `~\u002F.config\u002Fatxswap\u002F` (master.key + secrets.json).\n- Only **one wallet** is allowed per skill installation. If a wallet already\n  exists, `wallet.js create` fails.\n- Use `wallet.js list` before creating a wallet.\n- Importing an existing private key via this skill is **not supported**. If the\n  user asks to import a private key, refuse and tell them to use a dedicated\n  wallet tool of their choice.\n- Scripts write JSON output. `wallet.js export` prints the address's\n  encrypted **MetaMask-compatible keystore V3 JSON** to stdout (or writes it\n  to a file via `--out \u003Cfile>`); it never prints the raw private key.\n- `query.js quote` can return a JSON error if the configured Quoter or RPC\n  rejects the simulation. Surface the error and do not proceed to a write.\n- For balance, holdings, LP position, or pending-fee questions, always fetch\n  fresh on-chain data at request time. Do **NOT** answer from prior chat\n  output, memory, cached numbers, or earlier command results unless you rerun\n  the relevant query first.\n- For custom-range liquidity, do **not** guess the second token amount from chat.\n  First run `liquidity.js quote-add` or use `liquidity.js add --base-token ... --amount ...`\n  so the script computes the counter-asset from the live pool price and range.\n\n## Password Rules\n\nWhen the user asks to **create** a wallet:\n\n1. Ask the user for a password first (do NOT generate one).\n2. Pass it via `--password \u003Cpwd>` to the script when running non-interactively.\n3. The password is auto-saved to secure storage after creation.\n4. Never print the password back to the chat.\n5. After the wallet is created, export and send the encrypted keystore backup to\n   the user who requested the wallet.\n6. Clearly label it as encrypted keystore backup material, not the raw private key.\n7. Do not upload it to any website or send it to any third party.\n\nFor **swap**, **transfer**, and **liquidity** operations, rely on auto-unlock\nfirst. Only ask for the password if auto-unlock fails.\n\nIf the user says they forgot the wallet password or asks to recover it, first\nexplain that saved wallet passwords are encrypted at rest in the local\nSecretStore (for example Keychain, Secret Service, or the file backend under\n`~\u002F.config\u002Fatxswap\u002F`) and are not stored by the agent in chat memory. Even if\nthe user confirms, do **not** print the password in chat; guide them to use a\ntrusted local workflow instead.\n\n## Hard Safety Rules\n\n1. Treat all BSC writes as real-asset operations.\n2. **NEVER** output private keys or passwords in chat.\n3. **ALWAYS** run a preview before write actions: query price, quote, balance,\n   or positions as appropriate.\n4. **ALWAYS** show the preview to the user and wait for explicit confirmation\n   before swap, transfer, or liquidity writes.\n5. **NEVER** execute large trades without the user saying \"yes\" or \"confirm\".\n6. `wallet.js export` only emits the **encrypted MetaMask-compatible keystore\n   JSON**, never the raw private key. There is no command that prints the\n   unencrypted private key, and the agent must not attempt to derive or display\n   one.\n7. Prefer `wallet.js export \u003Caddress> --out \u003Cfile>` and tell the user the file\n   path. Avoid pasting the keystore JSON itself into chat unless the user\n   explicitly asks for it.\n8. Before deleting a wallet, keystore file, or any private-key-bearing wallet\n   material, **ALWAYS** remind the user to export and back up the encrypted\n   keystore first. Do not delete anything until the user explicitly confirms\n   that the keystore backup has been completed.\n9. Wallet deletion requires a second explicit confirmation: after backup is\n   confirmed, require the user to send the exact phrase `force delete wallet` before\n   running any delete command.\n10. If the user asks to delete a wallet, do **NOT** send the keystore\n    immediately. First ask whether they want to receive the encrypted keystore\n    backup. Only after the user agrees may you export and send the keystore to\n    the user.\n11. If the user explicitly asks to back up or export the wallet, export and\n    send the encrypted keystore backup to the user who requested the wallet,\n    and clearly label it as keystore backup material.\n12. The encrypted keystore may only be sent to the user who owns the current\n    session request. **NEVER** send the keystore through any channel that is not\n    under that user's own control.\n    It may only be sent to the user personally, and must not be pasted into any\n    external form or sent to any other person, group, agent, or service.\n13. After `wallet.js create` succeeds, export and send the encrypted keystore\n    to the user who requested the wallet. Treat this as part of the wallet\n    creation handoff, but only to that user.\n14. If the user asks to recover or reveal a saved wallet password, remind them\n   that the password is encrypted in local secure storage and must not be\n   disclosed in chat. Do not attempt to print, derive, or expose the password\n   even after user confirmation.\n15. If the user asks to recover, reveal, print, or paste the wallet private key,\n    refuse. Offer `wallet.js export \u003Caddress> --out \u003Cfile>` as the only\n    supported backup path, because it exports an encrypted keystore instead of\n    exposing the raw private key.\n16. For every transfer, treat the tuple `(asset, from, to, amount)` as a single\n    transfer intent. Repeat that exact tuple back to the user before execution.\n17. After a transfer command returns a `txHash`, consider that transfer intent\n    **already sent**. Do **NOT** send the same transfer again unless the user\n    explicitly asks to send it again.\n18. If a transfer write ends in an ambiguous state (for example RPC timeout,\n    dropped connection, or partial output after signing\u002Fsubmission), do **NOT**\n    retry blindly. First check chain state or wallet state, summarize what is\n    known, and ask the user whether to retry.\n19. If the same transfer tuple appears again in the same conversation after a\n    successful or ambiguous prior attempt, pause and ask whether the user means\n    a new transfer or is referring to the earlier one.\n20. For any user question about **current** balances, holdings, LP positions,\n    pending fees, or wallet assets, rerun the matching read command against the\n    chain first. Never rely on previously displayed numbers as if they were\n    still current.\n\n## Required Preview Flow\n\nBefore every write action:\n\n1. Query the price, quote, balance, or positions that match the requested action.\n2. Summarize the preview in plain language.\n3. Ask the user to confirm.\n4. Execute the write command only after confirmation.\n5. Return the transaction hash and the key result fields.\n\nFor transfers, the summary in step 2 must explicitly include:\n\n- asset\n- source wallet\n- destination address\n- amount\n\nAfter step 5, if a `txHash` is available, treat the transfer as executed and do\nnot issue the same write again unless the user clearly requests a second send.\n\nFor read-only asset questions:\n\n1. Run the relevant live query first (`query.js balance`, `query.js positions`,\n   `query.js price`, or `query.js quote` as appropriate).\n2. Answer from that fresh output only.\n3. If the RPC or query fails, say the data could not be refreshed instead of\n   reusing older numbers.\n\n## High-Value Workflows\n\n### Check market state\n\n```bash\ncd \"${SKILL_DIR}\" && node scripts\u002Fquery.js price\ncd \"${SKILL_DIR}\" && node scripts\u002Fquery.js balance \u003Caddress>\ncd \"${SKILL_DIR}\" && node scripts\u002Fquery.js positions \u003Caddress>\ncd \"${SKILL_DIR}\" && node scripts\u002Fquery.js positions \u003Caddress> \u003CtokenId>\n```\n\n### Preview before swap\n\n```bash\ncd \"${SKILL_DIR}\" && node scripts\u002Fquery.js quote \u003Cbuy|sell> \u003Camount>\n```\n\n### Execute after confirmation\n\n```bash\ncd \"${SKILL_DIR}\" && node scripts\u002Fswap.js buy \u003CusdtAmount> [--from address] [--slippage bps] [--password \u003Cpwd>]\ncd \"${SKILL_DIR}\" && node scripts\u002Fliquidity.js add \u003CatxAmount> \u003CusdtAmount> [range opts] [--from address] [--slippage-bps n] [--password \u003Cpwd>]\ncd \"${SKILL_DIR}\" && node scripts\u002Fliquidity.js add --base-token \u003Catx|usdt> --amount \u003Cn> [range opts] [--from address] [--slippage-bps n] [--password \u003Cpwd>]\ncd \"${SKILL_DIR}\" && node scripts\u002Ftransfer.js atx \u003Cto> \u003Camount> [--from address] [--password \u003Cpwd>]\n```\n\n## Command Reference\n\n### `wallet.js`\n\n```bash\ncd \"${SKILL_DIR}\" && node scripts\u002Fwallet.js create [name] --password \u003Cpwd>\ncd \"${SKILL_DIR}\" && node scripts\u002Fwallet.js list\ncd \"${SKILL_DIR}\" && node scripts\u002Fwallet.js export \u003Caddress> [--out \u003Cfile>]\ncd \"${SKILL_DIR}\" && node scripts\u002Fwallet.js has-password \u003Caddress>\ncd \"${SKILL_DIR}\" && node scripts\u002Fwallet.js forget-password \u003Caddress>\ncd \"${SKILL_DIR}\" && node scripts\u002Fwallet.js delete \u003Caddress> --backup-confirmed yes --force-phrase \"force delete wallet\"\n```\n\nAfter `wallet.js create`:\n\n1. Return the created wallet address.\n2. Run `wallet.js export \u003Caddress> [--out \u003Cfile>]`.\n3. Send the encrypted keystore only to the user who requested the wallet.\n4. Do not upload it to any website or send it to any third party.\n5. Explain that it is encrypted keystore backup material, not the raw private key.\n\nBefore `wallet.js delete`:\n\n1. Ask whether the user wants the encrypted keystore sent to them for backup.\n2. After the user agrees, export and send the encrypted keystore to the user only.\n3. Do not upload it to any website or send it to any third party.\n4. Require the user to explicitly confirm that the backup is complete.\n5. Require the user to send the exact phrase `force delete wallet`.\n6. Only then run `wallet.js delete \u003Caddress> --backup-confirmed yes --force-phrase \"force delete wallet\"`.\n\nIf the user asks to back up the wallet:\n\n1. Run `wallet.js export \u003Caddress> [--out \u003Cfile>]`.\n2. Send the encrypted keystore only to the user.\n3. Do not upload it to any website or send it to any third party.\n4. Explain that this is encrypted keystore backup material, not the raw private key.\n\n### `query.js`\n\n```bash\ncd \"${SKILL_DIR}\" && node scripts\u002Fquery.js price\ncd \"${SKILL_DIR}\" && node scripts\u002Fquery.js balance \u003Caddress>\ncd \"${SKILL_DIR}\" && node scripts\u002Fquery.js quote \u003Cbuy|sell> \u003Camount>\ncd \"${SKILL_DIR}\" && node scripts\u002Fquery.js positions \u003Caddress>\ncd \"${SKILL_DIR}\" && node scripts\u002Fquery.js positions \u003Caddress> \u003CtokenId>\ncd \"${SKILL_DIR}\" && node scripts\u002Fquery.js token-info \u003CtokenAddress>\n```\n\n`query.js positions` includes **principal token amounts** in the position (`principalAtx`,\n`principalUsdt`, `principal0`, `principal1`) computed from V3 `liquidity` (L), ticks (internal),\nand the pool’s current `sqrtPriceX96` (same `getAmountsForLiquidity` math as the web app). It emits\nhuman **USDT-per-ATX** bounds as **`priceRangeUsdtPerAtx.min` \u002F `.max`**, **`currentPriceUsdtPerAtx`**,\nand **`currentPriceInRange`** (whether the pool tick lies inside that position). It includes\n**`pendingFees.atx`** and **`pendingFees.usdt`** as the simulated collect notionals (`collectable*`),\nplus raw `tokensOwed0`\u002F`1` and `collectable0`\u002F`1` for debugging. Use `collectable*` \u002F `pendingFees`\nto decide whether a fee harvest is worth executing. Each object also includes **`feePercent`**\n(e.g. `\"0.25%\"`) for the pool’s swap-fee tier; raw **`fee`** stays the on-chain code\n(`100` \u002F `500` \u002F `2500` \u002F `10000`). **Tick indices are not included** in the JSON — quote\nUSDT\u002FATX prices and in-range state instead.\n\nWhen the user asks \"how much do I have now\", \"what is my current balance\", \"what\npositions are left\", \"how much ATX is still in the LP\", or similar present-tense\nquestions, rerun `query.js balance` and\u002For `query.js positions` immediately.\nDo not answer from previously captured JSON.\n\n**Required agent reply for holdings** when the user asks about their positions, LP NFTs, or liquidity holdings (per position):\n\nRun `query.js positions \u003Caddress>` (omit `tokenId` to list all ATX\u002FUSDT V3 NFTs). The CLI prints\n**one JSON object per NFT**; include **every** position. For each position, the answer **must**\naddress the topics below (label them in the user’s language when replying). **Do not** show raw\nV3 tick numbers to the user — use **USDT per 1 ATX** from the JSON below.\n\n| Topic | What to include | CLI JSON fields |\n|-------|-----------------|-----------------|\n| **Tokens in the position** | **In-range liquidity** as ATX and USDT notionals — always cite **`principalAtx`** and **`principalUsdt`** (and optionally `principal0` \u002F `principal1` in pool token0\u002Ftoken1 order). These are computed at the **current pool price**. Mention `liquidity` only as the raw **L** scalar if explaining detail. Do **not** treat **`query.js balance`** as LP “position tokens”: wallet ATX\u002FUSDT\u002FBNB balances are unrelated to NFT principal — if shown, label them distinctly (e.g. “Wallet balances, separate from this LP NFT”). |\n| **NFT token ID** | The V3 LP NFT id | `tokenId` |\n| **Pool swap fee tier** | The pool’s trading fee as a **percentage** for end users | Prefer **`feePercent`** (e.g. `\"0.25%\"`). If you show the raw tier code, pair it with **`feePercent`** (e.g. `2500` + `0.25%`). |\n| **Price range & spot** | Configured **min\u002Fmax USDT per 1 ATX** for the position, and current pool price in the same unit | **`priceRangeUsdtPerAtx.min`**, **`priceRangeUsdtPerAtx.max`**, **`currentPriceUsdtPerAtx`**, **`currentPriceInRange`** (confirm “in range” \u002F “out of range” in natural language). |\n| **Pending fees** | Uncollected fees (both tokens) | Always show **`pendingFees.atx`** and **`pendingFees.usdt`** explicitly. Prefer these over quoting only one asset. Optionally reference `collectableAtx`\u002F`collectableUsdt` synonyms. State fees stay **pending** until `liquidity.js collect`. |\n\nDo not answer with only raw pool indices (ticks). If there are no positions, relay `No ATX\u002FUSDT positions found.` exactly.\n\nMinor mismatch vs on-chain bookkeeping can occur because `principal*` uses the same float-based\ntick→√P path as other tooling (~wei-level); values are intended for humans and routing, not audits.\n\n### `swap.js`\n\n```bash\ncd \"${SKILL_DIR}\" && node scripts\u002Fswap.js buy \u003CusdtAmount> [--from address] [--slippage bps] [--password \u003Cpwd>]\ncd \"${SKILL_DIR}\" && node scripts\u002Fswap.js sell \u003CatxAmount> [--from address] [--slippage bps] [--password \u003Cpwd>]\n```\n\n### `liquidity.js`\n\n**`add` — price \u002F tick range** (same USDT\u002FATX semantics as the web app; default full range = full-width liquidity):\n\n- Default: no extra flags means **full range** (same as before).\n- `--full-range`: explicit full range (do not combine with the two groups below).\n- `--min-price` \u002F `--max-price`: band in **USDT per 1 ATX**; the script reads pool `token0` and maps to `tickLower` \u002F `tickUpper` like the app (`token1\u002Ftoken0` + `tickSpacing`). **Both** prices are required.\n- `--range-percent`: band around **current ATX price** as a percentage; e.g. `20` means about `-20%` to `+20%` of the current price.\n- `--tick-lower` \u002F `--tick-upper`: raw V3 ticks (**both** required; script uses the smaller as lower, larger as upper, clamped to valid V3 bounds).\n- `quote-add \u003Catx|usdt> \u003Camount>`: given live price and range, estimate the other leg — use before a write.\n- `add --base-token \u003Catx|usdt> --amount \u003Cn>`: single-sided notional; script computes the other leg and executes the add.\n\nOptional: `--slippage-bps` (0–10000; default from SDK).\n\n```bash\ncd \"${SKILL_DIR}\" && node scripts\u002Fliquidity.js quote-add \u003Catx|usdt> \u003Camount> [range opts]\ncd \"${SKILL_DIR}\" && node scripts\u002Fliquidity.js add \u003CatxAmount> \u003CusdtAmount> [range opts] [--from address] [--slippage-bps n] [--password \u003Cpwd>]\ncd \"${SKILL_DIR}\" && node scripts\u002Fliquidity.js add --base-token \u003Catx|usdt> --amount \u003Cn> [range opts] [--from address] [--slippage-bps n] [--password \u003Cpwd>]\ncd \"${SKILL_DIR}\" && node scripts\u002Fliquidity.js remove \u003CtokenId> \u003Cpercent> [--from address] [--password \u003Cpwd>]\ncd \"${SKILL_DIR}\" && node scripts\u002Fliquidity.js collect \u003CtokenId> [--from address] [--password \u003Cpwd>]\ncd \"${SKILL_DIR}\" && node scripts\u002Fliquidity.js burn \u003CtokenId> [--from address] [--password \u003Cpwd>]\n```\n\n`liquidity.js remove` already uses a single `multicall`:\n`decreaseLiquidity` -> `collect` -> and when `percent = 100`, `burn`.\nThat means a full removal automatically collects withdrawable funds and destroys the LP NFT in the same transaction, so\nrunning `collect` again for the same `tokenId` is expected to fail because the position no longer exists.\n\nBefore `collect`, preview the target position with:\n\n```bash\ncd \"${SKILL_DIR}\" && node scripts\u002Fquery.js positions \u003Caddress> \u003CtokenId>\n```\n\nPrefer `pendingFees` \u002F `collectableAtx` \u002F `collectableUsdt` over relying on `tokensOwed0\u002F1` alone when deciding whether\nfees are available, because the raw `tokensOwed` fields may stay at zero while\n`collect()` can still succeed.\n\nExample (not full-range; align the range with the user using `query.js price` before writes):\n\n```bash\ncd \"${SKILL_DIR}\" && node scripts\u002Fliquidity.js quote-add usdt 0.1 --range-percent 20\ncd \"${SKILL_DIR}\" && node scripts\u002Fliquidity.js add --base-token usdt --amount 0.1 --range-percent 20 --from \u003Caddress>\ncd \"${SKILL_DIR}\" && node scripts\u002Fliquidity.js add 10 1 --min-price 0.05 --max-price 0.15\ncd \"${SKILL_DIR}\" && node scripts\u002Fliquidity.js add 10 1 --tick-lower -20000 --tick-upper 1000\n```\n\nMapping user phrasing to commands:\n\n- If the user asks to add **0.1 USDT** of liquidity with a **±20%** range around spot, first run\n  `quote-add usdt 0.1 --range-percent 20`.\n- Show the returned `estimatedAmounts` (or equivalent summary) and wait for confirmation.\n- After confirmation, run\n  `add --base-token usdt --amount 0.1 --range-percent 20 --from \u003Caddress>`.\n\n### `transfer.js`\n\n```bash\ncd \"${SKILL_DIR}\" && node scripts\u002Ftransfer.js bnb \u003Cto> \u003Camount> [--from address] [--password \u003Cpwd>]\ncd \"${SKILL_DIR}\" && node scripts\u002Ftransfer.js atx \u003Cto> \u003Camount> [--from address] [--password \u003Cpwd>]\ncd \"${SKILL_DIR}\" && node scripts\u002Ftransfer.js usdt \u003Cto> \u003Camount> [--from address] [--password \u003Cpwd>]\ncd \"${SKILL_DIR}\" && node scripts\u002Ftransfer.js token \u003CtokenAddress> \u003Cto> \u003Camount> [--from address] [--password \u003Cpwd>]\n```\n\nTransfer anti-duplication checklist:\n\n1. Preview balances first.\n2. Restate the exact transfer tuple `(asset, from, to, amount)` to the user.\n3. Wait for explicit confirmation for that exact tuple.\n4. Run `transfer.js` once.\n5. Return the `txHash`.\n6. If the user repeats the same request, do not run the transfer again until\n   you clarify whether they want a second transfer.\n7. If the command may have submitted but the final result is unclear, do not\n   rerun it automatically; inspect chain state or ask the user how to proceed.\n\n## When To Refuse Or Pause\n\n- Missing wallet but the user requests a write action\n- Missing confirmation for swap, transfer, or liquidity writes\n- User asks to delete a wallet, keystore file, or private-key-bearing wallet\n  material before confirming that the encrypted keystore has been backed up\n- User asks to delete a wallet but has not agreed to receive the keystore backup first\n- User asks to delete a wallet but has not explicitly sent `force delete wallet`\n- User asks to send or upload a keystore through a channel not under their own\n  control, or to anyone other than the user\n- User asks to recover or reveal a saved wallet password in chat\n- User asks to recover, reveal, print, or paste a wallet private key in chat\n- `npm install` has not been run successfully in the skill directory\n- RPC, dependency, or wallet-unlock errors that make the state unclear\n\n## Standard Workflow\n\nFor any write action:\n\n1. Query current price, quote, balance, or positions as needed.\n2. Summarize the preview for the user.\n3. Wait for explicit confirmation.\n4. Execute the write command.\n5. Report the transaction hash and result.\n",{"name":5,"inject":24,"version":28,"metadata":29,"description":7,"compatibility":40},[25],{"as":26,"bash":27},"SKILL_DIR","echo \"${CLAUDE_SKILL_DIR:-$(cd \"$(dirname \"$0\")\u002F..\" && pwd)}\"","0.0.31",{"author":30,"openclaw":31},"agentswapx",{"os":32,"homepage":35,"requires":36},[33,34],"linux","macos","https:\u002F\u002Fgithub.com\u002Fagentswapx\u002Fskills\u002Ftree\u002Fmain\u002Fatxswap",{"bins":37},[38,39],"node","npm","Requires Node.js 18+ and npm. Network access to BSC RPC required.","master","4aa004da461d820f4ea5499e58eb8d196cf99016","community\u002Fclawhub\u002Fa\u002Fatxswap",0,"https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge","https:\u002F\u002Fskill-explorer-rho.vercel.app","https:\u002F\u002Fgithub.com\u002FLord1Egypt","Unbreakable. Unstoppable. Unmatched⚡.\r\n Speaker of machine tongues 🤖  | World-builder of decentralized dreams 🌐 | Defender of the digital realm🛡️.","2026-06-10 08:21:01",{"source":8,"skillName":5,"commands":51,"prompt":61,"zipAvailable":62},[52,55,58],{"tool":53,"command":54},"npx","npx skills add Lord1Egypt\u002Fawesome-skill-forge --skill atxswap",{"tool":56,"command":57},"bunx","bunx skills add Lord1Egypt\u002Fawesome-skill-forge --skill atxswap",{"tool":59,"command":60},"pnpm","pnpm dlx skills add Lord1Egypt\u002Fawesome-skill-forge --skill atxswap","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Fa\u002Fatxswap\u002FSKILL.md",true,[],[65,73,80,87,94,101],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":72},"01M785WKJB99G3STR1NF9NRTJW","youtube-content","YouTube transcripts to summaries, threads, blogs.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fyoutube-content\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":72},"01M785WEFHB0G2S9YA6EPR3H0E","xurl","X\u002FTwitter via xurl CLI: post, search, DM, media, v2 API.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fxurl\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":72},"01M785W98EDN4EFJXJPMQEHCRC","touchdesigner-mcp","Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftouchdesigner-mcp\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":72},"01M785W5S9FP3QBH2V191E025P","test-driven-development","TDD: enforce RED-GREEN-REFACTOR, tests before code.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":95,"name":96,"nameZh":6,"description":97,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":72},"01M785W2AS08NSSH9YATCV6FJB","teams-meeting-pipeline","Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fteams-meeting-pipeline\u002FSKILL.md",[],[],{"skillNo":102,"name":103,"nameZh":6,"description":104,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":105,"categories":106,"keywords":107,"publishedAt":72},"01M785VXKW4T34BTP1SCHW1R7F","systematic-debugging","4-phase root cause debugging: understand bugs before fixing.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fsystematic-debugging\u002FSKILL.md",[],[]]