Installation

Install the Vellum skill with a single command. No configuration files, no API keys needed upfront.

install
npx skills add https://github.com/vellum-finance/vellum-agent-skill

Or install with the --force flag to overwrite an existing install:

install --force
npx skills add https://github.com/Vellum-finance/vellum-agent-skill --force

Activation

After installing, activate the skill as a global command so your agent can invoke it from anywhere.

activate
cd ~/.agents/skills/vellum
npm install -g

Repository Structure

structure
vellum-agent-skill/ ├── skills/ │ └── vellum/ │ └── SKILL.md ├── cli.js ├── package.json ├── README.md └── vellum-agents.json ← auto-generated

Agent Register

Register your agent on Base. Generates a unique Agent ID and creates a Base wallet automatically. Run once per agent.

register
vellum register

Output: Agent ID, wallet address, and a vellum-agents.json file saved to your project directory.

Buy Token

Buy any token on Base using its contract address. Specify the amount in ETH.

buy
vellum buy --token 0xCONTRACT_ADDRESS --amount 0.01
FlagTypeDescription
--tokenaddressContract address of the token to buy
--amountETHAmount of ETH to spend

Sell Token

Sell a token back to ETH. Specify the token address and amount to sell.

sell
vellum sell --token 0xCONTRACT_ADDRESS --amount 1000

Transfer Assets

Send ETH or USDC to any address. Private key is prompted interactively and never stored.

transfer
vellum transfer --to 0xADDRESS --amount 0.05 --asset ETH
FlagTypeDescription
--toaddressRecipient wallet address
--amountnumberAmount to send
--assetETH · USDCAsset type to transfer

Security

Private keys are prompted interactively and handled in-memory only. They are never written to disk, never echoed to the terminal, and never logged.

Agent wallets are non-custodial — Vellum never holds your keys. The vellum-agents.json file stores only public metadata (Agent ID, wallet address).

Compatibility

Works with all major AI agent frameworks:

AgentStatus
Claude (Anthropic)✓ Supported
Gemini (Google)✓ Supported
GPT (OpenAI)✓ Supported
Grok (xAI)✓ Supported
Cursor✓ Supported
Hermes✓ Supported
Openclaw✓ Supported
Any MCP Agent✓ Supported

License

Vellum Agent Skill is licensed under the MIT License. Free to use, modify, fork, and distribute for both personal and commercial purposes.

github.com/vellum-finance/vellum-agent-skill →