Wallet Skills
ukey-wallet-skills provides the UKey Wallet capability layer used by AI coding assistants. Users describe what they want in natural language, and the skill pack chooses an appropriate safe route, checks the live schema when needed, and returns results in language users can understand.
Users should not manually write CLI commands. The CLI is only an implementation detail behind the skill pack.
Install First
| Client | Setup path |
|---|---|
| Claude Code | Run /plugin marketplace add UKeyHQ/ukey-wallet-skills, then /plugin install ukey-wallet-skills |
| Codex | Follow the UKey Wallet skills install guide |
| Cursor | Clone the UKey Wallet skills repository and point Cursor at the plugin directory |
| OpenCode / OpenClaw | Follow the matching install guide in the skills repository |
After installation, try prompts like these first:
Show my wallet balance and receiving address.
What Solana tokens are trending right now?
Quote 1 ETH to USDC. Do not execute yet.
Is this token safe before I buy it?
Skill Router
| Skill | Best for | Example prompt |
|---|---|---|
ukey-wallet | Login, active wallet, balances, receiving addresses, history, transfers, BTC or SOL wallet actions, hardware discovery | Show my wallet balance and receiving address. |
ukey-swap | Swap, buy, sell, convert, bridge, swap status, BTC sign-only PSBT | Swap 1 ETH to USDC, but show me the quote first. |
ukey-market | Prices, token search, trending, candles, liquidity, positions, BTC or SOL metrics, research | What Solana tokens are trending right now? |
ukey-security | Token audit, simulation, approval risk, hardware safety, secret-safety checks | Is this token safe before I buy it? |
Schema Contract
Each skill should treat the live CLI schema as the source of truth instead of relying on stale hard-coded examples.
| Check | Expected behavior |
|---|---|
| Capability discovery | Check the command list when support is unclear |
| Parameter selection | Inspect the command schema before choosing complex fields |
| Correct name mapping | Distinguish schema command names from user-facing command families |
| Unsupported fields | Stop and explain when the current schema does not expose a required field |
| Structured output | Prefer result, risk, route, and next step instead of raw terminal output |
Wallet
ukey-wallet handles UKey Wallet state, receiving addresses, transfers, BTC address types, and hardware sessions.
| Natural language | What the skill should do |
|---|---|
Connect my UKey Wallet. | Pair through App Transfer and summarize the active wallet |
What wallet am I using? | Show the login method, wallet type, address, and current device state |
Show my balance. | Use the active wallet automatically without asking for a pasted address |
Receive BTC. | Return a BTC receiving address and only ask for address type if needed |
Send 0.2 SOL to this address. | Keep the Solana context, validate the address, and move into confirmation |
Swap
ukey-swap handles UKey Wallet trading, buy, sell, convert, bridge, and BTC sign-only flows.
| Natural language | What the skill should do |
|---|---|
Swap 1 ETH to USDC. | Quote first, show the route and risk, then ask for confirmation before execution |
Buy $200 of PEPE on Ethereum. | Keep the Ethereum context, audit the token, then enter trade confirmation |
Bridge 500 USDC from Ethereum to Base. | Check bridge support before quoting |
Swap 0.01 BTC to USDC using taproot and sign only. | Keep taproot and return a signed or preview PSBT instead of broadcasting |
Yes, confirm the swap. | Only execute an order that has already been reviewed |
Market
ukey-market is for UKey Wallet read-only market data and research.
| Natural language | What the skill should do |
|---|---|
What is the BTC price? | Return the price and 24h change first, then offer chart or trend follow-up |
What tokens are trending right now? | Return a short trending list without starting a trade flow |
Search BONK on Solana. | Keep the Solana context and interpret identifiers as an SPL token or mint |
Show ETH liquidity. | Return liquidity or position-related views |
Give me a quick ETH analysis. | Provide bias, catalyst, risk, and one next step |
Market answers should remain read-only by default. Buy or swap flows should move into a separate confirmation step.
Security
ukey-security handles UKey Wallet risk checks and pre-action safety.
| Natural language | What the skill should do |
|---|---|
Is this token safe? | Run a token audit and explain the risk level and reasons |
Simulate approving this contract for all my USDC. | Simulate and highlight unlimited approval risk |
Send SOL to 0x... | Stop because the Solana and EVM address formats do not match |
Show me the App Transfer payload. | Refuse to reveal secrets and provide an active-session summary instead |
Is my hardware wallet safe to use? | Use device or auth status and verification checks, and never ask for the seed phrase |
Response Shape
Good skill responses should stay concise and result-first:
Route: swap-quote
Fields: chain=eth, from=ETH, to=USDC, amount=1
Quote: 1 ETH -> <estimated USDC>
Risk: <audit or simulation state>
Next: I can build the transaction and ask for confirmation.
Answers that move funds should end with a confirmation question. Read-only wallet and market answers should offer a useful follow-up instead of pushing directly into a trade.