rlusd-agent-skills

RLUSD Skills

rlusd-skills is the open source skill and documentation repository for RLUSD agent workflows. It packages the plugin metadata, skill definitions, reference docs, and verification tests that route prompts into the external rlusd-cli runtime.

If you want the executable runtime, use rlusd-cli. If you want the agent-facing prompts, routing rules, packaging metadata, and docs that sit on top of that runtime, use this repo.

What This Repo Includes

• 10 packaged RLUSD skills for routing, wallet preflight, payments, DeFi, fiat guidance, and x402
• docs that describe the current skill-facing CLI contract
• examples, security notes, and troubleshooting guides
• tests that keep the docs and skill text aligned with the external CLI

Current Coverage

• Ethereum reads plus prepared evm transfer and evm approve flows
• XRPL trust-line status, account info, trust-line prepare/execute, and payment prepare/execute flows
• DeFi venue discovery, live swap quotes, prepared swap flows, Curve LP preview/prepare/execute, and Aave supply preview/prepare/execute
• fiat onboarding, buy, and redeem guidance
• x402 buyer-side fetch flows with XRPL wallets
• supporting CLI docs for helper surfaces such as wallet keychain, wallet export-seed, send, price, market, tx, xrpl dex, xrpl amm, and faucet

Current Constraints

• this repo is skills/docs-only; runtime execution and changing metadata live in rlusd-cli
• bundled examples and registry-backed flows currently focus on ethereum-mainnet and xrpl-mainnet
• DeFi supply execution is aave-only
• Curve swap and LP flows are limited to the RLUSD/USDC pool on ethereum-mainnet
• fiat commands are guidance-only and do not automate provider onboarding or redemption submission
• there is no multisig or external signer backend yet

Installation

Claude Code

/plugin marketplace add t54-labs/rlusd-skills
/plugin install ripple@rlusd-agent-skills

Local clone

git clone https://github.com/t54-labs/rlusd-skills.git
cd rlusd-skills
/plugin marketplace add .
/plugin install ripple@rlusd-agent-skills

Runtime prerequisite

This repo depends on the external rlusd-cli runtime. For development and verification, keep a fresh clone of rlusd-cli on main:

git clone https://github.com/t54-labs/rlusd-cli.git
cd rlusd-cli
git checkout main
npm install
npm run build

You can also dogfood the plugin from a local checkout:

claude --plugin-dir .

Wallet Configuration

Prepared plans, wallet files, and runtime configuration live under rlusd-cli:

• plans: ~/.config/rlusd-cli/plans
• wallets: ~/.config/rlusd-cli/wallets
• config: ~/.config/rlusd-cli/config.yml

For write flows, prefer explicit wallet flags such as --from-wallet, --owner-wallet, and --wallet, plus RLUSD_WALLET_PASSWORD for local wallet decryption.

Common Flows

# Resolve RLUSD metadata
rlusd resolve asset --chain ethereum-mainnet --symbol RLUSD --json
rlusd resolve asset --chain xrpl-mainnet --symbol RLUSD --json

# Prepare an EVM transfer
rlusd evm transfer prepare \
  --chain ethereum-mainnet \
  --from-wallet ops \
  --to 0x1234567890123456789012345678901234567890 \
  --amount 25.5 \
  --json

# Prepare an XRPL payment
rlusd xrpl payment prepare \
  --chain xrpl-mainnet \
  --from-wallet treasury-xrpl \
  --to rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe \
  --amount 250 \
  --json

# Get a live swap quote
rlusd defi quote swap \
  --chain ethereum-mainnet \
  --venue uniswap \
  --from RLUSD \
  --to USDC \
  --amount 1000 \
  --json

# Fetch an x402-protected resource
rlusd x402 fetch \
  https://api.example.com/premium-feed \
  --wallet treasury-xrpl \
  --max-value 1 \
  --json

Most write paths follow prepare -> review -> execute, then wait or receipt for confirmation. rlusd-x402 is the exception: it is a capped direct-execution flow bounded by --max-value.

The examples in this repo pass explicit --chain and --venue for predictability. At runtime, top-level DeFi commands can also inherit --chain from the global flag or default_chain config, while execute commands load the venue from the stored plan. Use --venue uniswap when fee-tier selection matters, and --venue curve for the fixed Ethereum mainnet RLUSD/USDC pool. Top-level read and wallet commands may also use family aliases such as ethereum and xrpl, while network-scoped action flows use ethereum-mainnet and xrpl-mainnet.

Repository Layout