uniswap-ai — Claude Code skill: what it does, how to install
uniswap-ai is a Claude Code skill wrapping Uniswap's official set for trading, hooks, drivers and on-chain analysis on V2/V3/V4. It gives your coding agent commands for the protocol.
MIT 138 installs ★ 12 updated 2026-09-29
npx skills add okx/plugin-store --skill uniswap-ai -a claude-codeWhat uniswap-ai does
uniswap-ai wraps Uniswap's official tooling. The working code for trading, hooks, drivers and on-chain analysis sits in the full package — 5 sub-plugins and 10 skills, pulled in with npx skills add Uniswap/uniswap-ai -y -g. This entry points your agent at that package and keeps an eye on its version.
On first use in a session it looks for a newer release: a read-only call to raw.githubusercontent.com, cached for an hour. If something above 1.7.0 turns up, the agent has to print the notice and get your confirmation before running npx skills add okx/plugin-store --skill uniswap-ai --global. No silent overwrite.
The real work happens on-chain. The full Uniswap skill signs transactions and pushes them to the network, so slippage, contract risk, approval exposure and price impact come with it. Read each action before you confirm. Without the package from the first paragraph the wrapper has nothing to run.
What it helps with
- Write a hook for a V4 pool and check its logic
- Build a swap through a driver and see what goes on-chain
- Read pool data from V2 or V3 contracts
- Get the Uniswap skill set into your coding agent
- Check which approvals a contract asks for before confirming
Example prompts for the agent
- What does the
uniswap-aiskill give me? List the commands it adds. - Build a swap in a V3 pool with the Uniswap skill and show me the transaction before anything gets signed.
- Run the skill's version check and tell me whether an update is waiting.
How to install uniswap-ai
1Skills CLI (Vercel)
npx skills add okx/plugin-store --skill uniswap-ai -a claude-code2Manually: put the files in place
~/.claude/skills/uniswap-ai/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/uniswap-ai/
1Skills CLI (Vercel)
npx skills add okx/plugin-store --skill uniswap-ai -a codex2Manually: put the files in place
.agents/skills/uniswap-ai/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add okx/plugin-store --skill uniswap-ai -a cursor2Manually: put the files in place
.cursor/skills/uniswap-ai/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install okx/plugin-store skills/uniswap-ai2Manually: put the files in place
.github/skills/uniswap-ai/SKILL.md1Skills CLI (Vercel)
npx skills add okx/plugin-store --skill uniswap-ai -a gemini-cli2Platform CLI
gemini skills install https://github.com/okx/plugin-store --path skills/uniswap-aiManually: put the files in place
.devin/skills/uniswap-ai/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add okx/plugin-store --skill uniswap-ai -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 uniswap-ai
How do I install uniswap-ai in Claude Code?
Run npx skills add okx/plugin-store --skill uniswap-ai -a claude-code. The skill lands at ~/.claude/skills/uniswap-ai/SKILL.md.
What is uniswap-ai for?
It connects your agent to Uniswap's official tooling: trading, hooks, drivers and on-chain analysis across V2/V3/V4. The working skill set itself comes from npx skills add Uniswap/uniswap-ai -y -g.
Does it touch real funds?
The full Uniswap skill signs and broadcasts transactions on-chain, so yes. Price impact, slippage, contract risk and approval exposure all apply — review each step before confirming.
Source text
SKILL.md · MIT
---
name: uniswap-ai
description: "AI-powered Uniswap developer tools: trading, hooks, drivers, and on-chain analysis across V2/V3/V4"
version: "1.7.0"
author: "Uniswap"
tags:
- uniswap
- defi
---
## Pre-flight Dependencies (auto-injected by Plugin Store CI)
> Run once per session before first use. These checks ensure required tools are installed.
### Version check (auto-injected)
> **AI Agent Instruction**: Run this version check before executing any commands from this skill. The check is a read-only fetch from `raw.githubusercontent.com` — it does **not** install anything. If it reports `Update available`, you MUST stop, surface the message to the user verbatim, and obtain explicit confirmation before running the suggested `npx skills add …` command. Do not run the update silently. After a confirmed update completes, re-read this SKILL.md before proceeding.
```bash
# Check for skill updates (1-hour cache).
# Network scope: this block calls raw.githubusercontent.com for the version probe only.
# It does NOT install anything; install requires user-confirmed `npx skills add` below.
UPDATE_CACHE="$HOME/.plugin-store/update-cache/uniswap-ai"
CACHE_MAX=3600
LOCAL_VER="1.7.0"
DO_CHECK=true
if [ -f "$UPDATE_CACHE" ]; then
CACHE_MOD=$(stat -f %m "$UPDATE_CACHE" 2>/dev/null || stat -c %Y "$UPDATE_CACHE" 2>/dev/null || echo 0)
NOW=$(date +%s)
AGE=$(( NOW - CACHE_MOD ))
[ "$AGE" -lt "$CACHE_MAX" ] && DO_CHECK=false
fi
if [ "$DO_CHECK" = true ]; then
REMOTE_VER=$(curl -sf --max-time 3 "https://raw.githubusercontent.com/okx/plugin-store/main/skills/uniswap-ai/plugin.yaml" | grep '^version' | head -1 | tr -d '"' | awk '{print $2}')
if [ -n "$REMOTE_VER" ]; then
mkdir -p "$HOME/.plugin-store/update-cache"
echo "$REMOTE_VER" > "$UPDATE_CACHE"
fi
fi
REMOTE_VER=$(cat "$UPDATE_CACHE" 2>/dev/null || echo "$LOCAL_VER")
if [ "$REMOTE_VER" != "$LOCAL_VER" ]; then
echo "Update available: uniswap-ai v$LOCAL_VER -> v$REMOTE_VER."
echo "ACTION REQUIRED: ask the user to confirm before running:"
echo " npx skills add okx/plugin-store --skill uniswap-ai --global"
echo "(This contacts the npm registry and github.com/okx/plugin-store and overwrites this skill. Do NOT auto-run.)"
fi
```
---
# Uniswap AI
This skill is maintained by Uniswap Labs. Install the full version (all 5 sub-plugins / 10 skills):
```
npx skills add Uniswap/uniswap-ai -y -g
```
Source: [Uniswap/uniswap-ai](https://github.com/Uniswap/uniswap-ai)
> **Note:** This entry is a thin wrapper. The actual trading, hook, and analysis functionality lives in the official Uniswap skill installed by the command above. Because that skill signs and broadcasts on-chain transactions, using it carries normal DeFi risk (price impact, slippage, contract risk, approval exposure) — review each action before confirming.
© Uniswap · MIT · okx/plugin-store