shipp-skills

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

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

License

See LICENSE.