# grimoire-polymarket

Discovers Polymarket prediction markets and manages CLOB orderbook trades through the Grimoire venue CLI wrapper.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 11900 installs · ★ 6
- Author: franalgaba
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/franalgaba/grimoire/tree/HEAD/skills/grimoire-polymarket/SKILL.md
- Updated: 2026-05-08
- HTML: https://affpapa.org/en/nevibecode/skills/grimoire-polymarket

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add franalgaba/grimoire --skill grimoire-polymarket -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/grimoire-polymarket/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/grimoire-polymarket/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add franalgaba/grimoire --skill grimoire-polymarket -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/grimoire-polymarket/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add franalgaba/grimoire --skill grimoire-polymarket -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/grimoire-polymarket/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install franalgaba/grimoire grimoire-polymarket
```

2. **Manually: put the files in place**
- File: `.github/skills/grimoire-polymarket/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add franalgaba/grimoire --skill grimoire-polymarket -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/franalgaba/grimoire --path skills/grimoire-polymarket
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/grimoire-polymarket/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add franalgaba/grimoire --skill grimoire-polymarket -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/franalgaba/grimoire/tree/HEAD/skills/grimoire-polymarket/SKILL.md

## When to use it
- 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
- 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

## Similar
- [churn-prevention](https://affpapa.org/en/nevibecode/skills/coreyhaines31-churn-prevention.md) — skill · 121000 installs
- [revops](https://affpapa.org/en/nevibecode/skills/revops.md) — skill · 113500 installs
- [community-marketing](https://affpapa.org/en/nevibecode/skills/community-marketing.md) — skill · 89500 installs
- [ads](https://affpapa.org/en/nevibecode/skills/ads.md) — skill · 82800 installs
- [pricing](https://affpapa.org/en/nevibecode/skills/pricing.md) — skill · 79300 installs
- [marketing-plan](https://affpapa.org/en/nevibecode/skills/marketing-plan.md) — skill · 67900 installs

From the same set: [franalgaba/grimoire](https://affpapa.org/en/nevibecode/by/franalgaba/grimoire.md) — 2 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md