Retrieve Uniswap router metadata, token lists, and pool snapshots via CLI commands.
Works with
Four command categories: info (adapter overview), routers (by chain), tokens (by symbol or address), and pools (with fee and liquidity filtering)
Supports Uniswap V3 (SwapRouter02) and V4 (Universal Router with Permit2) adapters across multiple chains
Output formats include JSON, table, and spell (a params snapshot block for agent workflows)
Pools can query via The Graph API or onchain factory look
AI-first code editor with Composer
Before installing skills in Cursor, ensure your development environment meets these requirements:
node --versiongrimoire-uniswapExecute the skills CLI command in your project's root directory to begin installation:
Fetches grimoire-uniswap from franalgaba/grimoire and configures it for Cursor.
The CLI shows a list of agents. Use arrow keys and space to select Cursor:
Confirm successful installation by checking the skill directory location:
Restart Cursor to activate grimoire-uniswap. Access via /grimoire-uniswap in your agent's command palette.
We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.
Skills execute code in your environment. Always review source, verify the publisher, and test in isolation before production.
Submit your Claude Code skill and start earning
Create detailed user stories, acceptance criteria, and feature specs
Example
Generate user stories for 'password reset feature' with acceptance criteria, edge cases, and test scenarios
Reduce spec writing time by 50%, ensure comprehensive coverage
Research competitors, compare features, identify gaps
Example
Analyze 5 competitor products, create feature comparison matrix, suggest differentiation opportunities
Complete competitive research in 2 hours instead of 2 days
Evaluate features using frameworks (RICE, ICE, Kano) and create prioritized backlogs
Example
Score 20 feature ideas using RICE framework, generate prioritized roadmap with rationale
0
total installs
0
this week
3
GitHub stars
0
upvotes
Run in your terminal
0
installs
0
this week
3
stars
Use this skill to inspect Uniswap metadata and produce token/pool snapshots for spells.
Preferred invocations:
grimoire venue uniswap ...npx -y @grimoirelabs/cli venue uniswap ... (no-install)bun run packages/cli/src/index.ts venue uniswap ... (repo-local)grimoire-uniswap ... (direct binary from @grimoirelabs/venues)Recommended preflight:
grimoire venue doctor --adapter uniswap --chain 1 --rpc-url <rpc> --jsongrimoire venue uniswap info — adapter metadatagrimoire venue uniswap routers [--chain <id>] — router addresses per chaingrimoire venue uniswap tokens [--chain <id>] [--symbol <sym>] [--address <addr>] [--source <url>] — token list lookupgrimoire venue uniswap tokens-snapshot [--chain <id>] [--symbol <sym>] [--address <addr>] [--source <url>] — generate spell params: block for tokens (agent-only)grimoire venue uniswap pools --token0 <address|symbol> --token1 <address|symbol> [--chain <id>] [--fee <bps>] [--limit <n>] [--source <url>] [--endpoint <url>] [--graph-key <key>] [--subgraph-id <id>] [--rpc-url <url>] [--factory <address>] — find pools for a token pairgrimoire venue uniswap pools-snapshot --token0 <address|symbol> --token1 <address|symbol> [--chain <id>] [--fee <bps>] [--limit <n>] [--source <url>] [--endpoint <url>] [--graph-key <key>] [--subgraph-id <id>] [--rpc-url <url>] [--factory <address>] — generate spell params: block for pools (agent-only)Pools can be fetched from The Graph (subgraph) or directly from on-chain factory contracts:
GRAPH_API_KEY is set): queries The Graph decentralized network. Built-in subgraph IDs for Ethereum, Optimism, Polygon, Base, Arbitrum.--rpc-url/RPC_URL when provided, otherwise chain default RPC where available).--rpc-url and omit --graph-key.| Variable | Description |
|---|---|
GRAPH_API_KEY |
The Graph API key for subgraph queries (get one at https://thegraph.com/studio/apikeys/) |
RPC_URL |
Fallback RPC URL for on-chain pool lookups |
grimoire venue uniswap info --format table
grimoire venue uniswap routers
grimoire venue uniswap routers --chain 1
grimoire venue uniswap tokens --chain 1 --symbol USDC --format spell
grimoire venue uniswap pools --chain 1 --token0 USDC --token1 WETH --fee 3000 --format spell
grimoire venue uniswap pools --chain 8453 --token0 USDC --token1 WETH --fee 500 --rpc-url $RPC_URL --format table
grimoire venue uniswap pools --chain 8453 --token0 USDC --token1 WETH --fee 500 --graph-key $GRAPH_API_KEY --subgraph-id <id>
grimoire venue uniswap tokens-snapshot --chain 1 --symbol USDC
grimoire venue uniswap pools-snapshot --chain 1 --token0 USDC --token1 WETH --rpc-url $RPC_URL
Use tokens-snapshot or pools-snapshot to emit a params: block for spell inputs. These are agent-only commands (output suppressed in interactive mode).
Uniswap V3 and V4 expose quote_out for protocol comparison:
v3_out = metric("quote_out", uni_v3, USDC, "asset_out=WETH,amount=1000000,fee_tier=3000")
v4_out = metric("quote_out", uni_v4, USDC, "asset_out=WETH,amount=1000000,fee_tier=3000,tick_spacing=60")
Selector fields:
asset_outamount (defaults to 1 unit of input asset), fee_tiertick_spacingWhen writing swap actions in .spell files targeting Uniswap, use with clauses to set constraints:
uniswap_v3.swap(USDC, WETH, params.amount) with (
fee_tier=3000,
max_slippage=50,
min_output=900000000000000,
deadline=300,
)
fee_tier is required. The adapter throws if fee_tier is not specified. It is an action parameter (not a constraint) and is extracted from the with() clause.
Common fee tiers: 500 (0.05%), 3000 (0.3%), 10000 (1%).
| Parameter | Type | Description |
|---|---|---|
fee_tier |
integer (bps) | Required. Uniswap pool fee tier (e.g. 500, 3000, 10000) |
| Constraint | Type | Description |
|---|---|---|
max_slippage |
integer (bps) | Maximum slippage in basis points (e.g. 50 = 0.5%) |
min_output |
integer (wei) | Minimum output amount floor |
max_input |
integer (wei) | Maximum input amount cap |
deadline |
integer (seconds) | Transaction deadline from now |
require_quote |
boolean | Fail if on-chain quote fetch fails |
require_simulation |
boolean | Fail if simulation unavailable |
max_gas |
integer (wei) | Gas estimate cap |
Always set both max_slippage and min_output for swaps to prevent unexpected losses.
| Adapter | Router | Approval Flow |
|---|---|---|
@uniswap_v3 |
SwapRouter02 | Standard ERC20 approve |
@uniswap_v4 |
Universal Router | Permit2 |
createUniswapV4Adapter().tokens, pools), use grimoire venue uniswap ... even when your spell venue is uniswap_v4.tokens and pools also support --format spell.--format json for automation and reproducible snapshots.Make data-driven prioritization decisions faster
Draft PRDs, status updates, and stakeholder presentations
Example
Create executive summary of Q3 roadmap, monthly progress report, feature launch announcement
Save 3-5 hours/week on communication overhead
Prerequisites
Time Estimate
30-60 minutes to see productivity improvements
Steps
Common Pitfalls
✓ Do
✗ Don't
💡 Pro Tips
✓ Use when
Use for user story writing, competitive research, roadmap prioritization, stakeholder communication, and PRD drafting. Best for reducing repetitive documentation and research work.
✗ Avoid when
Avoid for strategic product vision (requires deep customer empathy), pricing decisions (needs market and financial expertise), or when face-to-face customer discovery is more valuable than speed.
mattpocock/skills
parcadei/continuous-claude-v3
cursor/plugins
ailabs-393/ai-labs-claude-skills
pproenca/dot-skills
mattpocock/skills
We added grimoire-uniswap from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
I recommend grimoire-uniswap for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
grimoire-uniswap reduced setup friction for our internal harness; good balance of opinion and flexibility.
grimoire-uniswap has been reliable in day-to-day use. Documentation quality is above average for community skills.
grimoire-uniswap fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
Useful defaults in grimoire-uniswap — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
grimoire-uniswap is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
grimoire-uniswap has been reliable in day-to-day use. Documentation quality is above average for community skills.
Useful defaults in grimoire-uniswap — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
grimoire-uniswap has been reliable in day-to-day use. Documentation quality is above average for community skills.
showing 1-10 of 59