Using Skills

Prerequisite: All skills require authentication. The authenticate-wallet skill handles this automatically — just tell your agent "log me in" and provide the OTP from your email.

How Skills Work

Each skill guides your AI agent through a multi-step workflow with built-in decision points. Unlike raw CLI commands, skills handle the full lifecycle: check prerequisites → preview/quote → confirm with user → execute → verify result.

Transaction Skills

Trade

What the agent does: Checks auth → gets a swap quote → shows expected output and fees → waits for user confirmation → executes → verifies on-chain status.

starkfi trade 0.1 ETH USDC
starkfi trade 100 USDC STRK --slippage 0.5
starkfi trade 0.5 ETH DAI --simulate     # Preview only

Agent decision points:

• Selects the best provider automatically (fibrous, avnu, ekubo, or auto to race all)
• Warns if slippage exceeds 2%
• Falls back to alternative provider if the primary one fails

Multi-Swap

What the agent does: Validates all pairs (2–3 max) → gets batch quotes → shows combined output → executes atomically in one transaction.

starkfi multi-swap "100 USDC>ETH, 50 DAI>STRK"
starkfi multi-swap "0.1 ETH>USDC, 200 USDT>DAI" --simulate

Agent decision points:

• Rejects if more than 3 pairs are requested (BATCH_LIMIT_EXCEEDED)
• Uses batch routing when all pairs share the same output token for efficiency

Batch (Multicall)

What the agent does: Parses mixed operations → validates each one → simulates the combined transaction → executes atomically.

starkfi batch \
  --swap "0.1 ETH USDC" \
  --stake "50 STRK karnot" \
  --simulate

Supports: --swap, --stake, --supply, --send, --borrow, --repay, --withdraw, --dca-create, --dca-cancel. Minimum 2 operations required.

Agent decision points:

• Determines which operations can be safely batched together
• Always simulates first to estimate combined gas cost
• If any operation in the batch would fail, the entire batch is rejected (atomic)

Staking

What the agent does: Lists validators → helps user choose → checks existing position → stakes/unstakes/claims → verifies result.

starkfi validators                         # List validators
starkfi pools karnot                       # List pools for a validator
starkfi stake 100 -v karnot                # Stake (default: STRK)
starkfi rewards --claim -v karnot          # Claim rewards
starkfi unstake intent -v karnot -a 50     # Start unstaking (step 1)
starkfi unstake exit -v karnot             # Complete unstaking (step 2)
starkfi stake-status                       # View staking overview

Agent decision points:

• Recommends validators based on commission rates and available pools
• For unstaking, explains the 2-step process and cooldown period
• Checks if exit cooldown has passed before attempting to complete withdrawal

Lending (Vesu V2)

What the agent does: Lists pools with live APY → helps choose pool/token pair → monitors health factor → auto-rebalances risky positions.

starkfi lend-pools                                  # List pools
starkfi lend-supply 100 -p Prime -t USDC            # Supply
starkfi lend-borrow -p Prime \                      # Borrow
  --collateral-amount 0.5 --collateral-token ETH \
  --borrow-amount 500 --borrow-token USDC
starkfi lend-repay 500 -p Prime -t USDC \           # Repay
  --collateral-token ETH
starkfi lend-status                                 # View positions
starkfi lend-monitor                                # Health monitoring
starkfi lend-auto -p Prime \                        # Auto-rebalance
  --collateral-token ETH --borrow-token USDC --simulate

Agent decision points:

• Warns user when health factor is in WARNING/DANGER/CRITICAL zones
• For auto-rebalance, chooses strategy (repay debt vs add collateral) based on wallet balances
• Prevents borrowing that would create immediately risky positions (health factor < 1.1)

Send

What the agent does: Validates address → checks balance → previews fee → confirms with user → executes → provides explorer link.

starkfi send 10 STRK 0x04a3...abc
starkfi send 0.5 ETH 0x07b1...def --simulate

Agent decision points:

• Validates recipient address format before sending
• Warns if the transfer would leave insufficient balance for gas

DCA (Dollar-Cost Averaging)

What the agent does: Previews one cycle → shows expected output → creates recurring order → monitors active orders.

starkfi dca-preview 10 USDC ETH                                # Preview
starkfi dca-create 1000 USDC ETH --per-cycle 10 --frequency P1D # Create daily
starkfi dca-list --status ACTIVE                                # List orders
starkfi dca-cancel <order-id-or-address>                        # Cancel

Agent decision points:

• Always previews before creating to show per-cycle output
• Defaults to daily frequency (P1D) if not specified
• Can cancel by UUID or on-chain contract address

Confidential Transfers (Tongo Cash)

What the agent does: Checks if Tongo is configured → guides through setup if needed → manages fund/transfer/withdraw lifecycle.

starkfi conf-setup --key <TONGO_KEY> --contract <ADDR>   # One-time setup
starkfi conf-balance                                     # Check state
starkfi conf-fund 100 --token USDC                       # Fund from public
starkfi conf-transfer 50 \                               # Private transfer
  --recipient-x 0xABC --recipient-y 0xDEF
starkfi conf-withdraw 100                                # Withdraw to public
starkfi conf-ragequit                                    # Emergency exit
starkfi conf-rollover                                    # Activate pending

Agent decision points:

• Checks for CONFIDENTIAL_NOT_CONFIGURED error and guides through setup
• Reminds recipients to run conf-rollover to activate received funds
• Double-confirms before conf-ragequit (destructive — empties entire balance)

Data Skills

Balance

What the agent does: Fetches balances → formats with token symbols → shows USD values when available.

starkfi balance               # All non-zero tokens
starkfi balance --token STRK  # Specific token
starkfi balance --json        # Machine-readable

Portfolio

What the agent does: Aggregates token balances, staking positions, lending positions, DCA orders, and confidential balances into a comprehensive dashboard.

starkfi portfolio                                                        # Full dashboard
starkfi portfolio-rebalance --target "50 ETH, 30 USDC, 20 STRK" --simulate # Preview
starkfi portfolio-rebalance --target "50 ETH, 30 USDC, 20 STRK"           # Execute

Agent decision points:

• For rebalance, calculates optimal trades to reach target allocation
• Always previews the rebalance plan before executing
• Validates that target percentages sum to 100

Utility Skills

Config

What the agent does: Manages CLI settings and checks transaction status.

starkfi config set-rpc <url>              # Custom RPC
starkfi config set-network mainnet        # Switch network
starkfi config set-gasfree on             # Developer-sponsored gas
starkfi config set-gas-token USDC         # Pay gas in USDC
starkfi config list                       # Show all settings
starkfi tx-status 0x0abc...               # Check any transaction

Global Flags

All skills support these flags:

See Also

• Agent Skills Overview — Installation, skill structure, and how agents match skills
• CLI Reference — Full command reference with all flags and options
• MCP Tools — Atomic tool equivalents for direct API integration