grimoire-polymarket Skill (Grimoire): Polymarket Data

Makes Claude search Polymarket markets, read order book data and manage CLOB orders through the Grimoire CLI.

Installs: 11.9K; on skills.sh
Stars: 6; on GitHub
Updated: May 2026; last repo commit

grimoire-polymarket tells Claude to use grimoire venue polymarket ... for market discovery, CLOB market data and order management. The wrapper sits on top of the official Polymarket CLI and restricts what an agent can call. Discovery uses search-markets, or the passthrough markets and data groups.

Order placement, cancel and heartbeat are spell actions that run through Grimoire with a Polymarket private key. This skill is by Grimoire Labs, not Polymarket. It needs the Grimoire CLI and the official polymarket binary.

Good for

Traders researching Polymarket markets and positions
Developers writing Grimoire spells that trade on Polymarket
People who want an agent to query Polymarket from the command line

Install grimoire-polymarket

Claude Code

Copy this prompt.

Install the grimoire-polymarket skill in Claude Code. Run this command:

npx skills add https://github.com/franalgaba/grimoire

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

The README and install guide document npx skills add for the whole Grimoire repo, which holds 8 skill folders (counted from the git tree). This skill also needs two command line tools. The Grimoire CLI runs the commands (global install or npx -y), and the official polymarket CLI is the backend. SKILL.md says the official binary is required. There is no Claude app upload route, because the skill runs local CLIs. This skill is not by Polymarket.

From the project README. Source.

What's in the skill

When it loads

Queries Polymarket market data and CLOB state, and manages CLOB orders via the Grimoire venue CLI wrapper backed by the official Polymarket CLI.

Sections in SKILL.md

Commands
Examples
Runtime Configuration
Spell Actions
Metric Surface (Spell Comparisons)
Adapter Notes
Notes

Key facts

Author: Grimoire Labs (named in plugin.json), published under the franalgaba GitHub account; not by Polymarket
License: MIT per the README License section. The repo has no LICENSE file in its git tree and SKILL.md names no license
Installs on skills.sh: 11,933 (Nov 2, 2026)
GitHub stars: 6 (Nov 2, 2026)
Last repo commit: May 8, 2026
What it includes: 1 file, SKILL.md. No scripts.
Needs: The Grimoire CLI (npm i -g @grimoirelabs/cli, or npx -y @grimoirelabs/cli) and the official polymarket CLI (brew tap Polymarket/polymarket-cli && brew install polymarket)
Part of: The Grimoire repo, which holds 8 skill folders in its git tree. A root plugin manifest (.claude-plugin/plugin.json, plugin name grimoire-vm) also exists

What it includes

Preflight check: grimoire venue doctor --adapter polymarket --json
SKILL.md recommends this plus the info command before use.
Runs code · venue doctor
Shows wrapper and adapter information
Runs code · polymarket info
Searches markets by query, slug, tag, category, league or sport
It has many filters such as --open-only, --active-only and --limit.
Runs code · polymarket search-markets
Official CLI market commands: list, get, search and tags
Runs code · markets (passthrough)
Official CLI data commands such as positions, trades and leaderboard
Runs code · data (passthrough)
book, price, midpoint, spread, order, trades, open-orders and more
SKILL.md says not to use them in new agent flows.
Runs code · Legacy aliases
Places a limit order (GTC, GTD) or market order (FOK, FAK)
Runs as a custom spell action and needs a Polymarket private key.
Runs code · Order spell action
cancel_order, cancel_orders, cancel_all and heartbeat
Delete · Cancel and heartbeat actions
Compares a CLOB token midpoint inside a spell
Read · mid_price metric

From the official docs

Permissions

High risk

grimoire-polymarket can place and cancel real orders with a Polymarket private key. Our advice: use a small separate wallet, and try the search and data commands before you set any key.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It can place and cancel orders with your key
SKILL.md lists order, cancel_order, cancel_orders and cancel_all as supported spell operations and POLYMARKET_PRIVATE_KEY as required by default. The official Polymarket CLI README says the key signs orders and on-chain transactions. Use a small, separate wallet. Our advice: do not run it unattended; confirm each order yourself. github.com
The official Polymarket CLI is early software
Its README warns that it is early, experimental software, to use at your own risk and not with large amounts of funds. This skill depends on it as the backend. github.com
It can run packages it downloads
SKILL.md lists npx -y @grimoirelabs/cli as a no-install route and a brew install for the official CLI. Both run third-party code on your machine. github.com
The wrapper blocks several command groups
SKILL.md says wallet, bridge, approve, ctf, setup, upgrade and shell are blocked in the wrapper and not exposed for agents. Order spells still run through Grimoire. github.com
Grimoire previews before irreversible actions
The README says Grimoire has one runtime semantics: preview first, then commit for irreversible actions. Check how your spell is run before you rely on that. github.com

Technical details

Turning on read-only	No read-only switch. The wrapper restricts passthrough to markets and data groups, but order spells run when a key is set.
Talks to	Polymarket APIs via the official polymarket CLI
Sign-in and keys	POLYMARKET_PRIVATE_KEY (required by default for spell execution); optional POLYMARKET_API_KEY, POLYMARKET_API_SECRET, POLYMARKET_API_PASSPHRASE, POLYMARKET_SIGNATURE_TYPE and POLYMARKET_FUNDER (SKILL.md).
Scopes	Runs grimoire and polymarket CLI commands Can place, cancel and heartbeat Polymarket CLOB orders in spells Reads POLYMARKET_PRIVATE_KEY and optional API credentials from the environment

Questions

What does grimoire-polymarket do?

It makes Claude query Polymarket market data and the order book, and manage CLOB orders, through the Grimoire venue CLI. The wrapper runs on top of the official Polymarket CLI.

How do I install it?

Use the install box at the top. The Grimoire README documents installing the whole repo with the skills CLI. You also need the Grimoire CLI and the official polymarket CLI, which the box lists.

Is it by Polymarket?

No. SKILL.md describes a Grimoire wrapper "backed by the official Polymarket CLI". The skill is from the Grimoire project, and its plugin manifest names Grimoire Labs as author.

Can it place real trades?

Yes, through spell actions. SKILL.md lists order, cancel_order, cancel_orders, cancel_all and heartbeat as supported operations, and says POLYMARKET_PRIVATE_KEY is required by default for spell execution. The official Polymarket CLI README says its key signs orders and on-chain transactions.

Can it read market data without a key?

SKILL.md does not say. It lists the private key under runtime auth for spell execution, and gives the discovery commands without one. Our advice: start with search-markets and the data commands before you set any key.

What is blocked?

The wrapper blocks the official CLI groups wallet, bridge, approve, ctf, setup, upgrade and shell, which SKILL.md says are intentionally not exposed for agents. The orders it can still manage run as spell actions.

Does it work in the Claude app?

No upload route is offered, because the skill runs local command line tools. The install box covers Claude Code, Codex and the skills CLI.

Is it safe?

High risk if you give it a key: it can place and cancel real orders with a Polymarket private key, and it is not made by Polymarket. The Polymarket CLI README warns it is early, experimental software and not to be used with large amounts of funds. Our advice: do not let an agent trade unattended. Use a separate wallet with a small balance, start with search-markets and the data commands, and confirm every order yourself before it runs.

Information

updated Nov 2, 2026

Repository: franalgaba/grimoire
Folder: skills/grimoire-polymarket

franalgaba/grimoire skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 5

grimoire-polymarket SKILL.md · github.com
Grimoire README · github.com
Install Grimoire skills guide · github.com
plugin.json · github.com
skills.sh listing · skills.sh