Skip to main content
The Voltr Agent Skill is an Agent Skill that teaches a coding agent (such as Claude Code) how to build on Voltr. Install it once and your agent can scaffold vaults, deposit/withdraw flows, custom adaptors, and CPI integrations — grounded in the official docs and the on-chain programs instead of guessing.
The Skill activates automatically when a task matches its triggers — Voltr vaults, @voltr/vault-sdk, sdk-scripts, adaptors, CPI into the vault program, and related terms.

​
Install

Copy or symlink the repo into your agent’s skills location. For Claude Code: 
git clone https://github.com/voltrxyz/voltr-skill.git

# project-level (this repo only):
mkdir -p .claude/skills && cp -r voltr-skill .claude/skills/voltr

# …or user-level (all your projects):
cp -r voltr-skill ~/.claude/skills/voltr

​
What’s inside

The Skill uses progressive disclosure: the agent loads SKILL.md first for orientation and a track picker, then pulls in only the dense reference and runnable example it needs for the task at hand.
You are…GoalReferenceRunnable code
Vault managerCreate, configure, allocate, and operate a vaultvault-manager-cli.md (recommended) · vault-manager-sdk.mdexamples/sdk/
Depositor / app devDeposit & withdraw for users (frontend, bot, service)depositor-and-api.mdexamples/depositor/
Yield protocolBuild a custom on-chain adaptor bridging a vault to your protocoladaptor-creation.mdexamples/adaptor/
Composing protocolCPI into the vault program from your own programcpi-integration.mdexamples/cpi/
A shared architecture.md reference underpins all four tracks: programs, fund flow, roles, accounting (LP / asset-per-LP / locked profit / high water mark / fees), PDAs, deployed addresses, and the instruction and error lists.

​
How it relates to these docs

The Skill is grounded in this documentation and the same tooling it describes — it is a way to build with an AI agent, not a replacement for the references here:

CLI & Scripts

The sdk-scripts CLI and examples the manager track builds on

SDK Reference

The @voltr/vault-sdk v2 surface the Skill targets

Adaptor Creation

The three-instruction adaptor interface for yield protocols

CPI Integration

Composing protocols that CPI into the vault program
The TypeScript surface targets v2 (@voltr/vault-sdk + @solana/kit); the legacy VoltrClient (v1) API is out of scope except as a migration source. Always preview transactions (print → simulate) before executing on mainnet, and verify program addresses and discriminators against the Skill’s architecture.md and cpi-integration.md.