Shipp Skills

Skills for Shipp — the real-time data connector for AI builders.

Available on ClawHub

To install, run in your terminal (Or ask Claude, Codex etc.)

npx skills add outsharp/shipp-skills

---

What Are These Skills?

Shipp Skills teach AI agents (Claude Code, coding assistants, autonomous agents) how to integrate with real-time data APIs. Each skill provides context, authentication patterns, endpoint references, and usage guidance so an agent can build working integrations without guesswork.

Available Skills

Skill	Description
shipp	Real-time data connector — fetch live event streams (sports, and more) via the Shipp API
kalshi	Regulated prediction market exchange — market data, trading, portfolio management, WebSocket streaming
metaculus	Forecasting platform — browse questions, submit forecasts, read community predictions, CDF generation, comments
polymarket	Decentralized prediction market on Polygon — market discovery, CLOB trading, orderbooks, WebSocket streaming, CTF operations
google-news	Google News RSS feeds — top stories, topic feeds, keyword search, and multi-region news aggregation (no API key required)
openfootball	Football (soccer) match data — fixtures, results, and scores for Premier League, Bundesliga, La Liga, Serie A, Ligue 1, World Cup, and more (no API key required)
noaa-weather	NOAA Weather.gov API — forecasts, active alerts, station observations, radar, aviation weather, and more for the US (no API key required)

Quick Start

1. Get your API keys

   • Shipp API Key — for real-time data
   • Kalshi API Key — for prediction market trading (demo account recommended)
   • Metaculus API Token — for forecasting platform access (all endpoints require auth)
   • Polymarket Wallet — for decentralized prediction market trading (Ethereum private key + funded Polygon wallet with USDCe; read-only market data requires no auth)
   • Google News — no API key or account needed; all RSS feeds are fully public
   • openfootball — no API key or account needed; all JSON data is fully public
   • NOAA Weather API — no API key needed; just include a User-Agent header

2. Add the skills to your agent's context via ClawHub or by referencing the SKILL.md files directly.

3. Build something. The skills give your agent everything it needs to call the APIs, handle auth, and process responses.

Example Project: Alph Bot

Alph Bot is an open-source trading bot that demonstrates both skills working together in a real application. It uses Shipp for live sports data and Kalshi for prediction market trading — with Claude AI estimating probabilities in between.

What Alph Bot Does

• Fetches real-time game events from Shipp (NBA, NFL, MLB, NHL, Soccer)
• Uses Claude AI to estimate outcome probabilities from live game state
• Identifies mispriced markets on Kalshi using value betting strategy
• Executes trades automatically with configurable risk management

How It Uses the Skills

Shipp skill in practice — Alph Bot creates a Shipp connection for a specific game, then polls for live events using cursor-based pagination (since_event_id). The schema-flexible data[] responses are fed directly to Claude for analysis.

Kalshi skill in practice — Alph Bot searches Kalshi markets related to the game, reads orderbook prices, compares them against AI-estimated probabilities, and places orders when it finds sufficient edge.

Try It

git clone https://gitlab.com/outsharp/shipp/alph-bot.git
cd alph-bot

cp .env.example .env
# Add your API keys to .env

yarn migrate

# List available games
./index.ts available-games --sport NBA

# Run value betting on a specific game (paper mode)
./index.ts value-bet -d --paper --game <GAME_ID>

Warning: Alph Bot involves risking real money when not in paper/demo mode. Always test thoroughly before live trading.

Documentation & Resources

Resource	URL
Shipp Docs	docs.shipp.ai
Shipp How-To Guide	docs.shipp.ai/how-to
Shipp API Reference	docs.shipp.ai/api-reference
Shipp Dashboard	platform.shipp.ai
Kalshi Docs	docs.kalshi.com
Kalshi LLM Docs	docs.kalshi.com
Metaculus API Docs	metaculus.com/api
Polymarket Docs	docs.polymarket.com
Polymarket LLM Docs	docs.polymarket.com/llms.txt
Google News RSS (US)	news.google.com/rss?hl=en-US&gl=US&ceid=US:en
openfootball / football.json	github.com/openfootball/football.json
openfootball GitHub Pages	openfootball.github.io
NOAA Weather API Docs	weather.gov/documentation/services-web-api
Alph Bot	gitlab.com/outsharp/shipp/alph-bot

License

See LICENSE.