grimoire-polymarket — Claude Code skill: what it does, how to install
Discovers Polymarket prediction markets and manages CLOB orderbook trades through the Grimoire venue CLI wrapper.
npx skills add franalgaba/grimoire --skill grimoire-polymarket -a claude-codeWhat grimoire-polymarket does
This skill connects Claude Code to Polymarket prediction markets using the Grimoire venue adapter. It helps the assistant locate active events and filter outcomes by sport, category, or keyword. The agent inspects CLOB orderbook depth, monitors midpoints, and reviews wallet positions. Flag --format json ensures CLI output remains clean for programmatic processing.
Order placement targets Polygon (Chain ID 137), routing limit options (GTC, GTD) or market execution (FOK, FAK). Critical operations like bridge handling, wallet transfers, and contract approvals remain blocked in this wrapper. Agents cannot trigger those commands.
Without the official polymarket CLI utility installed on your path, commands fail immediately. Submitting trades also requires exporting POLYMARKET_PRIVATE_KEY in your environment.
What it helps with
- search active Polymarket events by topic or league
- read CLOB orderbook midpoint prices and book depth
- inspect wallet trade history and current token balances
- route limit and market orders on Polygon
Example prompts for the agent
- Search active Polymarket events about crypto with grimoire venue polymarket search-markets
- Get current market info and prices in JSON format via grimoire venue polymarket info --format json
- Check open orders and wallet positions on Polymarket
How to install grimoire-polymarket
1Skills CLI (Vercel)
npx skills add franalgaba/grimoire --skill grimoire-polymarket -a claude-code2Manually: put the files in place
~/.claude/skills/grimoire-polymarket/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/grimoire-polymarket/
1Skills CLI (Vercel)
npx skills add franalgaba/grimoire --skill grimoire-polymarket -a codex2Manually: put the files in place
.agents/skills/grimoire-polymarket/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add franalgaba/grimoire --skill grimoire-polymarket -a cursor2Manually: put the files in place
.cursor/skills/grimoire-polymarket/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install franalgaba/grimoire grimoire-polymarket2Manually: put the files in place
.github/skills/grimoire-polymarket/SKILL.md1Skills CLI (Vercel)
npx skills add franalgaba/grimoire --skill grimoire-polymarket -a gemini-cli2Platform CLI
gemini skills install https://github.com/franalgaba/grimoire --path skills/grimoire-polymarketManually: put the files in place
.devin/skills/grimoire-polymarket/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add franalgaba/grimoire --skill grimoire-polymarket -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-polymarket
How to install grimoire-polymarket in Claude Code?
Run npx skills add franalgaba/grimoire --skill grimoire-polymarket -a claude-code. The skill writes to ~/.claude/skills/grimoire-polymarket/SKILL.md.
What does grimoire-polymarket do?
It equips coding assistants with CLI tools to discover Polymarket events, inspect CLOB orderbooks, and submit trading orders.
What dependencies are required beforehand?
You need the official polymarket binary installed via brew tap Polymarket/polymarket-cli && brew install polymarket. Trading operations also need POLYMARKET_PRIVATE_KEY.
