minor improvements

AyushBherwani1998 · AyushBherwani1998 · commit 0e8d41522b6f · 2026-06-10T13:31:59.000+04:00
diff --git a/skills/metamask-agent-wallet/references/swap.md b/skills/metamask-agent-wallet/references/swap.md
@@ -9,7 +9,7 @@ Get a swap or bridge quote showing expected output, fees, and route.
 ### Syntax
 
 ```bash
-mm swap quote --from <token> --to <token> --amount <amount> --from-chain <chain-id> [--to-chain <chain-id>] [--slippage <percent>]
+mm swap quote --from <token> --to <token> --amount <amount> --from-chain <chain-id> [--to-chain <chain-id>] [--to-address <address>] [--slippage <percent>]
 ```
 
 ### Supported Flags
@@ -21,6 +21,7 @@ mm swap quote --from <token> --to <token> --amount <amount> --from-chain <chain-
 | `--amount` | Yes | Human-readable amount to swap (e.g. 0.5, 100) |
 | `--from-chain` | Yes | Source EVM chain ID (e.g. 1 for Ethereum, 137 for Polygon) |
 | `--to-chain` | No | Destination EVM chain ID; defaults to `--from-chain` for same-chain swaps |
+| `--to-address` | No | Recipient address for swapped/bridged output tokens; defaults to the signer's wallet |
 | `--slippage` | No | Maximum slippage as a percentage, 0-100 (defaults to 0.5) |
 
 ### Example
@@ -30,6 +31,7 @@ mm swap quote --from ETH --to USDC --amount 0.5 --from-chain 1
 mm swap quote --from USDC --to USDT --amount 100 --from-chain 137
 mm swap quote --from ETH --to USDC --amount 1 --from-chain 1 --to-chain 137
 mm swap quote --from ETH --to USDC --amount 0.5 --from-chain 1 --slippage 1
+mm swap quote --from ETH --to pUSD --amount 0.5 --from-chain 1 --to-chain 137 --to-address 0x742d...f2bD18
 ```
 
 ## `swap execute` Command
@@ -40,7 +42,7 @@ Execute a swap or bridge, either by referencing a previous quote ID or by provid
 
 ```bash
 mm swap execute --quote-id <id> [--password <password>]
-mm swap execute --from <token> --to <token> --amount <amount> --from-chain <chain-id> [--to-chain <chain-id>] [--slippage <percent>] [--password <password>]
+mm swap execute --from <token> --to <token> --amount <amount> --from-chain <chain-id> [--to-chain <chain-id>] [--to-address <address>] [--slippage <percent>] [--password <password>]
 ```
 
 ### Supported Flags
@@ -53,6 +55,7 @@ mm swap execute --from <token> --to <token> --amount <amount> --from-chain <chai
 | `--amount` | Yes (unless `--quote-id`) | Amount to swap |
 | `--from-chain` | Yes (unless `--quote-id`) | Source EVM chain ID |
 | `--to-chain` | No | Destination EVM chain ID; defaults to `--from-chain` for same-chain swaps |
+| `--to-address` | No | Recipient address for swapped/bridged output tokens; defaults to the signer's wallet. Persisted quotes retain the recipient for `--quote-id` execution |
 | `--slippage` | No | Maximum slippage as a percentage, 0-100 (defaults to 0.5) |
 | `--password` | No | Password to unlock the BYOK mnemonic (BYOK mode only) [env: `MM_PASSWORD`] |
 
diff --git a/skills/metamask-agent-wallet/workflows/bridge.md b/skills/metamask-agent-wallet/workflows/bridge.md
@@ -1,4 +1,4 @@
-# Bridge Workflow
+# Bridge workflow
 
 Use this workflow when the user wants to bridge tokens across chains.
 
@@ -10,7 +10,7 @@ Reference command syntax in `references/swap.md`. The CLI uses the same `swap` c
 2. Confirm with the user.
 3. Execute and track status.
 
-Do not skip the quote review step. It is where the user sees output amount, fees, route, and slippage.
+Don't skip the quote review step. The user needs to see output amount, fees, route, and slippage before executing.
 
 ## Quote
 
@@ -20,8 +20,14 @@ mm swap quote --from ETH --to USDC --amount 1 --from-chain 1 --to-chain 137 --sl
 
 Required flags: `--from`, `--to`, `--amount`, `--from-chain`, and `--to-chain`.
 
+If the user wants the bridged tokens sent to a different wallet on the destination chain, add `--to-address`:
+
+```bash
+mm swap quote --from ETH --to USDC --amount 1 --from-chain 1 --to-chain 137 --to-address 0x742d...f2bD18
+```
+
 Persist the quote id for execution. Show the quote to the user before execution.
-Confirm source token, destination token, amount, source chain, destination chain, slippage, expected output, fees, and route.
+Confirm source token, destination token, amount, source chain, destination chain, slippage, expected output, fees, route, and recipient address (if `--to-address` was set).
 
 ## Execute
 
@@ -40,7 +46,7 @@ mm swap status --quote-id "QUOTE_ID" --tx-hash 0xabc123
 
 Use status polling for bridges where the destination side can lag behind the source transaction.
 
-## Edge Cases
+## Edge cases
 
 - Quote expired: re-quote and ask the user to review the new quote.
 - Insufficient balance: surface the error verbatim.
diff --git a/skills/metamask-agent-wallet/workflows/perps-open-position.md b/skills/metamask-agent-wallet/workflows/perps-open-position.md
@@ -1,4 +1,4 @@
-# Perps Open Position Workflow
+# Perps open position workflow
 
 Use this workflow when the user wants to open a new perpetual position.
 
@@ -11,29 +11,63 @@ Reference command syntax in `references/perps.md`.
 3. Dry run.
 4. Confirm with the user and open.
 
-## Confirm Symbol
+## Confirm symbol
 
-If the user does not mention a token symbol, list available markets and confirm with the user:
+If the user doesn't mention a token symbol, list available markets and confirm with the user:
 
 ```bash
 mm perps markets
 ```
 
-## Check Balance
+## Check balance
 
-`--venue` defaults to `hyperliquid`. It can be omitted.
+`--venue` defaults to `hyperliquid`. You can omit it.
 
 ```bash
 mm perps balance
 ```
 
 If available margin is zero or insufficient, deposit USDC before proceeding. Hyperliquid only supports deposits from Arbitrum mainnet (`eip155:42161`).
 
+Check the user's Arbitrum balance for USDC and ETH (for gas).
+
+```bash
+mm wallet balance --chain 42161
+```
+
+### No ETH and no USDC on Arbitrum
+
+Inform the user that ETH on Arbitrum is required for gas. Without ETH, no on-chain transaction is possible. Bridge from another chain.
+
+```bash
+mm swap quote --from <TOKEN> --to ETH --amount 0.001 --from-chain <SOURCE_CHAIN_ID> --to-chain 42161
+mm swap execute --quote-id "$QUOTE_ID" # quote ID from the swap quote command
+```
+
+Once the user has ETH for gas, swap or bridge to get USDC on Arbitrum.
+
+```bash
+mm swap quote --from <TOKEN> --to USDC --amount <AMOUNT> --from-chain <SOURCE_CHAIN_ID> --to-chain 42161
+mm swap execute --quote-id "$QUOTE_ID" # quote ID from the swap quote command
+```
+
+### Has ETH or another token on Arbitrum (but no USDC)
+
+Swap to USDC on Arbitrum.
+
+```bash
+mm swap quote --from <TOKEN> --to USDC --amount <AMOUNT> --from-chain 42161
+mm swap execute --quote-id "$QUOTE_ID" # quote ID from the swap quote command
+```
+
+### Has ETH and USDC on Arbitrum
+
+Deposit USDC directly into Hyperliquid.
+
 ```bash
-mm perps deposit --amount <amount> --asset USDC
+mm perps deposit --amount <AMOUNT> --asset USDC
 ```
 
-To confirm a deposit, wait briefly and poll `mm perps balance`.
 
 ## Quote
 
@@ -45,7 +79,7 @@ mm perps quote --symbol BTC --side long --size 0.01 --leverage 5
 
 Show the user estimated entry, notional, fees, liquidation price, side, size, leverage, and venue before proceeding.
 
-## Dry Run
+## Dry run
 
 Preview the order before signing:
 
@@ -65,4 +99,4 @@ Remove `--dry-run` only after explicit user confirmation:
 mm perps open --symbol BTC --side long --size 0.01 --leverage 5
 ```
 
-Do not add `--yes` unless the user explicitly asked for unattended execution.
+Don't add `--yes` unless the user explicitly asked for unattended execution.
diff --git a/skills/metamask-agent-wallet/workflows/predict-funding.md b/skills/metamask-agent-wallet/workflows/predict-funding.md
@@ -17,51 +17,58 @@ mm predict balance --sync
 
 ## Deposit
 
-If the user doesn't specify an amount, ask how much they want to deposit. Then check the user's Polygon balance for USDC.e and POL.
+If the user doesn't specify an amount, ask how much they want to deposit. Get the deposit wallet address from `mm predict balance --sync`, then check the user's Polygon balance.
 
 ```bash
 mm wallet balance --chain 137
 ```
 
-### No POL and no USDC.e
+### Has POL and pUSD on Polygon
 
-Tell the user to acquire POL on Polygon first. Without POL, no on-chain transaction is possible. Check if the user has tokens on another chain to bridge POL from.
+Use `mm transfer` to send pUSD directly to the deposit wallet address. No conversion needed.
 
 ```bash
-mm swap quote --from <TOKEN> --to POL --amount 1 --from-chain <SOURCE_CHAIN_ID> --to-chain 137
+mm transfer --to <DEPOSIT_WALLET_ADDRESS> --amount <AMOUNT> --chain-id 137 --token pUSD --wait
 ```
 
-Once the user has POL, swap to USDC.e.
+Get the deposit wallet address from the `mm predict balance` output.
+
+### Has POL and USDC.e on Polygon
+
+Run `mm predict deposit`. The CLI converts USDC.e to pUSD in the deposit wallet.
 
 ```bash
-mm swap quote --from POL --to USDC.e --amount <AMOUNT> --from-chain 137
+mm predict deposit --amount <AMOUNT> --wait
 ```
 
-### Has POL but not enough to swap for USDC.e
+`--amount` is in USDC.e. The owner EOA needs enough USDC.e and POL for gas on Polygon.
 
-If the user's POL balance is too low for a swap, bridge USDC.e from another chain.
+### Has POL or another token on Polygon (but no USDC.e or pUSD)
+
+Swap to USDC.e on Polygon, then deposit.
 
 ```bash
-mm swap quote --from <TOKEN> --to USDC.e --amount <AMOUNT> --from-chain <SOURCE_CHAIN_ID> --to-chain 137
+mm swap quote --from <TOKEN> --to USDC.e --amount <AMOUNT> --from-chain 137
+mm swap execute --quote-id "$QUOTE_ID" # quote ID from the swap quote command
 ```
 
-### Has enough POL or other tokens on Polygon
-
-Swap directly into USDC.e.
+After the swap completes, deposit:
 
 ```bash
-mm swap quote --from <TOKEN> --to USDC.e --amount <AMOUNT> --from-chain 137
+mm predict deposit --amount <AMOUNT> --wait
 ```
 
-After the bridge or swap completes, re-check the balance before proceeding.
+### Has assets on another chain
 
-### Execute deposit
+Bridge to send pUSD directly to the deposit wallet address on Polygon.
 
 ```bash
-mm predict deposit --amount <AMOUNT> --wait
+mm swap quote --from <TOKEN> --to pUSD --amount <AMOUNT> --from-chain <SOURCE_CHAIN_ID> --to-chain 137 --to-address <DEPOSIT_WALLET_ADDRESS>
+mm swap execute --quote-id "$QUOTE_ID" # quote ID from the swap quote command
 ```
 
-`--amount` is in USDC.e. The CLI converts USDC.e to pUSD in the deposit wallet upon deposit. The owner EOA needs enough USDC.e on Polygon and POL for gas to complete the transaction.
+Get the deposit wallet address from the `mm predict balance` output. This avoids the extra deposit step.
+
 
 ## Withdraw
 
diff --git a/skills/metamask-agent-wallet/workflows/swap.md b/skills/metamask-agent-wallet/workflows/swap.md
@@ -1,4 +1,4 @@
-# Swap Workflow
+# Swap workflow
 
 Use this workflow when the user wants to swap tokens on the same chain.
 
@@ -10,7 +10,7 @@ Reference command syntax in `references/swap.md`.
 2. Confirm with the user.
 3. Execute and track status.
 
-Do not skip the quote review step. It is where the user sees output amount, fees, route, and slippage.
+Don't skip the quote review step. The user needs to see output amount, fees, route, and slippage before executing.
 
 ## Quote
 
@@ -20,8 +20,14 @@ mm swap quote --from ETH --to USDC --amount 1 --from-chain 1
 
 Required flags: `--from`, `--to`, `--amount`, and `--from-chain`.
 
+If the user wants the output tokens sent to a different wallet, add `--to-address`:
+
+```bash
+mm swap quote --from ETH --to USDC --amount 1 --from-chain 1 --to-address 0x742d...f2bD18
+```
+
 Persist the quote id for execution. Show the quote to the user before execution.
-Confirm source token, destination token, amount, chain, slippage, expected output, fees, and route.
+Confirm source token, destination token, amount, chain, slippage, expected output, fees, route, and recipient address (if `--to-address` was set).
 
 ## Execute
 
@@ -37,7 +43,7 @@ Prefer executing by quote ID. Re-quote-and-execute flags exist, but quote ID exe
 mm swap status --quote-id "$QUOTE_ID"
 ```
 
-## Edge Cases
+## Edge cases
 
 - Quote expired: re-quote and ask the user to review the new quote.
 - Insufficient balance: surface the error verbatim.
diff --git a/skills/metamask-agent-workflows/workflows/bridge.md b/skills/metamask-agent-workflows/workflows/bridge.md
@@ -1,4 +1,4 @@
-# Bridge Workflow
+# Bridge workflow
 
 Use this workflow when the user wants to bridge tokens across chains.
 
@@ -10,7 +10,7 @@ Reference command syntax in `references/swap.md`. The CLI uses the same `swap` c
 2. Confirm with the user.
 3. Execute and track status.
 
-Do not skip the quote review step. It is where the user sees output amount, fees, route, and slippage.
+Don't skip the quote review step. The user needs to see output amount, fees, route, and slippage before executing.
 
 ## Quote
 
@@ -20,8 +20,14 @@ mm swap quote --from ETH --to USDC --amount 1 --from-chain 1 --to-chain 137 --sl
 
 Required flags: `--from`, `--to`, `--amount`, `--from-chain`, and `--to-chain`.
 
+If the user wants the bridged tokens sent to a different wallet on the destination chain, add `--to-address`:
+
+```bash
+mm swap quote --from ETH --to USDC --amount 1 --from-chain 1 --to-chain 137 --to-address 0x742d...f2bD18
+```
+
 Persist the quote id for execution. Show the quote to the user before execution.
-Confirm source token, destination token, amount, source chain, destination chain, slippage, expected output, fees, and route.
+Confirm source token, destination token, amount, source chain, destination chain, slippage, expected output, fees, route, and recipient address (if `--to-address` was set).
 
 ## Execute
 
@@ -40,7 +46,7 @@ mm swap status --quote-id "QUOTE_ID" --tx-hash 0xabc123
 
 Use status polling for bridges where the destination side can lag behind the source transaction.
 
-## Edge Cases
+## Edge cases
 
 - Quote expired: re-quote and ask the user to review the new quote.
 - Insufficient balance: surface the error verbatim.
diff --git a/skills/metamask-agent-workflows/workflows/perps-open-position.md b/skills/metamask-agent-workflows/workflows/perps-open-position.md
diff --git a/skills/metamask-agent-workflows/workflows/predict-funding.md b/skills/metamask-agent-workflows/workflows/predict-funding.md
diff --git a/skills/metamask-agent-workflows/workflows/swap.md b/skills/metamask-agent-workflows/workflows/swap.md
