grimoire-aave — Claude Code skill: Aave V3 market data
Pulls public Aave V3 market data through the Grimoire CLI: protocol health, chain listings, market and reserve metadata. Handy when an agent needs strategy inputs.
npx skills add franalgaba/grimoire --skill grimoire-aave -a claude-codeWhat grimoire-aave does
The skill wraps grimoire venue aave commands and returns JSON or a table. You get a protocol health check, the list of supported chains, markets on a chain, a single market, a single reserve, and reserves with filters by market or asset. The reserves-snapshot command builds a params: block for a spell; it is meant for agents, and interactive mode suppresses its output.
Run grimoire venue doctor --adapter aave --chain 1 --rpc-url <rpc> --json first, as the README advises. No working RPC URL means the network calls fail, so skipping that check costs you time. Four ways to invoke it exist: the installed grimoire, npx -y @grimoirelabs/cli, a repo-local bun run packages/cli/src/index.ts, or the grimoire-aave binary from @grimoirelabs/venues.
Every endpoint is read-only. In automation --format json works better; keep the table for quick manual checks. One caveat: Aave V3 actions in spells do not support runtime constraints such as max_slippage or min_output yet, and the adapter handles approvals and amount conversion for you. Amount format differs by action — supply and borrow take a human-readable value, withdraw and repay take a raw number inside an exact wrapper.
What it helps with
- check Aave protocol health before a trade
- list chains where Aave is deployed
- fetch market metadata by address
- inspect reserves for an asset like USDC
- build a
params:block for a spell from a reserves snapshot
Example prompts for the agent
- Check Aave health with
grimoire venue aave health - List Aave markets on chain 1 as a table
- Snapshot USDC reserves and build the
params:block for a spell
How to install grimoire-aave
1Skills CLI (Vercel)
npx skills add franalgaba/grimoire --skill grimoire-aave -a claude-code2Manually: put the files in place
~/.claude/skills/grimoire-aave/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/grimoire-aave/
1Skills CLI (Vercel)
npx skills add franalgaba/grimoire --skill grimoire-aave -a codex2Manually: put the files in place
.agents/skills/grimoire-aave/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add franalgaba/grimoire --skill grimoire-aave -a cursor2Manually: put the files in place
.cursor/skills/grimoire-aave/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install franalgaba/grimoire grimoire-aave2Manually: put the files in place
.github/skills/grimoire-aave/SKILL.md1Skills CLI (Vercel)
npx skills add franalgaba/grimoire --skill grimoire-aave -a gemini-cli2Platform CLI
gemini skills install https://github.com/franalgaba/grimoire --path skills/grimoire-aaveManually: put the files in place
.devin/skills/grimoire-aave/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add franalgaba/grimoire --skill grimoire-aave -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about grimoire-aave
How do I install grimoire-aave in Claude Code?
Run npx skills add franalgaba/grimoire --skill grimoire-aave -a claude-code. The skill lands in ~/.claude/skills/grimoire-aave/SKILL.md.
What does grimoire-aave do?
It queries public Aave V3 data through the Grimoire CLI: protocol health, chains, markets, reserves, and a reserves snapshot for spells.
What do I need for the skill to work?
A working RPC URL — the README advises running grimoire venue doctor --adapter aave --chain 1 --rpc-url <rpc> --json first. All commands are read-only.
