skills/franalgaba/grimoire-polymarket/SKILL.md
Queries Polymarket market data and CLOB state, and manages CLOB orders via the Grimoire venue CLI wrapper backed by the official Polymarket CLI.
npx skillsauth add aiskillstore/marketplace grimoire-polymarketInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Use this skill for Polymarket market discovery, CLOB market data, and order-management operations through the polymarket venue adapter.
Preferred invocations:
grimoire venue polymarket ...npx -y @grimoirelabs/cli venue polymarket ... (no-install)bun run packages/cli/src/index.ts venue polymarket ... (repo-local)grimoire-polymarket ... (direct binary from @grimoirelabs/venues)Recommended preflight:
grimoire venue doctor --adapter polymarket --jsongrimoire venue polymarket info --format jsonCanonical agent commands:
grimoire venue polymarket info [--format <auto|json|table>]grimoire venue polymarket search-markets [--query <text>] [--slug <slug|url>] [--question <text>] [--event <text>] [--tag <text>] [--category <text>] [--league <text>] [--sport <text>] [--open-only <true|false>] [--active-only <true|false>] [--ignore-end-date <true|false>] [--tradable-only <true|false>] [--all-pages <true|false>] [--max-pages <n>] [--stop-after-empty-pages <n>] [--limit <n>] [--format <auto|json|table>]Allowed passthrough groups (official CLI surface, restricted by wrapper policy):
markets (list|get|search|tags)events (list|get|tags)tags (list|get|related|related-tags)series (list|get)sports (list|market-types|teams)clob (book/prices/markets/orders/trades/etc.)data (positions/value/leaderboards/etc.)statusBlocked groups in this wrapper (intentionally not exposed for agents):
walletbridgeapprovectfsetupupgradeshellLegacy compatibility aliases are still supported (market, book, midpoint, spread, price, last-trade-price, tick-size, neg-risk, fee-rate, price-history, order, trades, open-orders, balance-allowance, closed-only-mode, server-time) but should not be used for new agent flows.
# Wrapper/health
grimoire venue polymarket info --format json
grimoire venue polymarket status --format json
# Canonical discovery
grimoire venue polymarket search-markets --query bitcoin --active-only true --open-only true --format json
grimoire venue polymarket search-markets --category sports --league "la liga" --active-only true --open-only true --format json
# Official passthrough discovery/data
grimoire venue polymarket markets list --limit 25 --format json
grimoire venue polymarket markets search "atleti" --limit 25 --format json
grimoire venue polymarket events list --limit 25 --format json
grimoire venue polymarket clob book <token_id> --format json
grimoire venue polymarket clob midpoint <token_id> --format json
grimoire venue polymarket clob price <token_id> --side buy --format json
# Authenticated order-management reads
grimoire venue polymarket clob order <order_id> --format json
grimoire venue polymarket clob trades --market <condition_id> --format json
grimoire venue polymarket clob orders --market <condition_id> --format json
grimoire venue polymarket clob balance --asset-type conditional --token <token_id> --format json
Adapter/runtime auth (for spell execution and authenticated CLOB operations):
POLYMARKET_PRIVATE_KEYPOLYMARKET_API_KEY, POLYMARKET_API_SECRET, POLYMARKET_API_PASSPHRASEPOLYMARKET_DERIVE_API_KEY=true|falsePOLYMARKET_SIGNATURE_TYPE (0 EOA, 1 POLY_PROXY, 2 GNOSIS_SAFE), POLYMARKET_FUNDERVenue CLI backend:
polymarketbrew tap Polymarket/polymarket-cli && brew install polymarketPOLYMARKET_OFFICIAL_CLI=/custom/path/polymarketpolymarketoffchain137 (Polygon)customorder, cancel_order, cancel_orders, cancel_all, heartbeatOrder argument aliases accepted:
token_id or tokenID or tokenId or coinsize or amountBUY/SELLGTC/GTD/FOK/FAKarg0..arg5, reduce_onlyOrder type routing:
GTC/GTD -> limit order path (createAndPostOrder)FOK/FAK -> market order path (createAndPostMarketOrder)--format json for agent and automation workflows.search-markets is the agent-oriented normalized discovery command; passthrough markets search is thinner and closer to official behavior.development
Apple Human Interface Guidelines for content display components. Use this skill when the user asks about charts component, collection view, image view, web view, color well, image well, activity view, lockup, data visualization, content display, displaying images, rendering web content, color pickers, or presenting collections of items in Apple apps. Also use when the user says how should I display charts, what's the best way to show images, should I use a web view, how do I build a grid of items, what component shows media, or how do I present a share sheet. Cross-references: hig-foundations for color/typography/accessibility, hig-patterns for data visualization patterns, hig-components-layout for structural containers, hig-platforms for platform-specific component behavior.
tools
Automate HelpDesk tasks via Rube MCP (Composio): list tickets, manage views, use canned responses, and configure custom fields. Always search tools first for current schemas.
testing
Expert Haskell engineer specializing in advanced type systems, pure functional design, and high-reliability software. Use PROACTIVELY for type-level programming, concurrency, and architecture guidance.
tools
GraphQL gives clients exactly the data they need - no more, no less. One endpoint, typed schema, introspection. But the flexibility that makes it powerful also makes it dangerous. Without proper controls, clients can craft queries that bring down your server. This skill covers schema design, resolvers, DataLoader for N+1 prevention, federation for microservices, and client integration with Apollo/urql. Key insight: GraphQL is a contract. The schema is the API documentation. Design it carefully.