Forecast OS Lite
precog-markets/forecast-os-lite is an MIT-licensed Agent Skill (SKILL.md, commit a8402f8) for querying live market-implied probabilities and contract metadata from Polymarket, Kalshi, and Precog Markets (service.precog.markets). The skill operates strictly via read-only HTTP GET requests: it places zero trades, signs zero transactions, reads zero local wallets or private keys, and writes zero files to disk.
1. Supported prediction venues & read-only endpoints
Pinned at commit a8402f8, forecast-os-lite defines structured curl/HTTP GET patterns in a compact SKILL.md so coding and research agents can pull normalized probability snapshots across three public prediction market sources:
- Polymarket (
gamma-api.polymarket.com): reads active event listings, contract outcomes, implied probability percentages, and volume/liquidity fields from Polymarket's public Gamma REST endpoints. - Kalshi (
external-api.kalshi.com): queries US-regulated event contracts, strike prices, ticker series, and order-book midpoints via Kalshi's public market-data GET endpoints. - Precog Markets (
service.precog.markets): fetches aggregated forecast feeds and multi-venue probability context without requiring user API keys or wallet pairing.
Primary workflow role: use this skill when an agent needs real-time crowd-implied event odds (macro announcements, elections, tech releases, or sports probabilities) inside research summaries or decision briefings without installing heavy Python trading SDKs.
2. Install via npx skills or manual SKILL.md symlink
1. Cross-agent CLI install (npx skills):
npx skills add precog-markets/forecast-os-lite
2. Direct Git clone + SKILL.md symlink (Claude Code, Codex CLI, Cursor):
git clone https://github.com/precog-markets/forecast-os-lite.git
# Claude Code user skills
ln -s "$(pwd)/forecast-os-lite" ~/.claude/skills/forecast-os-lite
# Cross-agent standard path (Codex CLI & Agent Skills hosts)
ln -s "$(pwd)/forecast-os-lite" ~/.agents/skills/forecast-os-lite
Restart or open a new agent session so the skill manifest registers cleanly. For broader skill authoring and verification conventions, read How to create an AI agent skill and Agent skill security vetting.
3. Security, custody & execution boundaries
- Zero execution or wallet risk:
SKILL.mdrestricts all network activity to unauthenticatedHTTP GETreads against the three documented market hosts. It does not invokePOSTorder placement, Ethereum signing, Solana keypairs, or browser HTML scraping. - Zero filesystem writes: querying odds returns structured JSON directly in context without writing cache databases or state files into your working repository.
- Probability framing: implied market prices reflect participant positioning and spread liquidity at query time, not calibrated guarantees or financial advice. Cross-check thin-volume contracts before citing implied odds downstream.
Frequently asked questions
Can Forecast OS Lite execute Polymarket or Kalshi trades?
No. At commit a8402f8, precog-markets/forecast-os-lite is strictly read-only HTTP GET. It has no POST endpoints, no private key handling, and no order execution tools.
Does Forecast OS Lite require API keys or a crypto wallet?
No. All three documented market sources (gamma-api.polymarket.com, external-api.kalshi.com, and service.precog.markets) are queried using public read endpoints with no embedded API keys or local wallet access.
Which agent clients support npx skills add precog-markets/forecast-os-lite?
Any Agent Skills (SKILL.md) compatible host including Claude Code, OpenAI Codex CLI, Cursor, and Gemini CLI supports either npx skills add precog-markets/forecast-os-lite or symlinking the folder into ~/.claude/skills/ or ~/.agents/skills/.