Skip to content

Sports Skills

Sports Skills is a free, open-source collection of Agent Skills that give an AI agent structured access to public sports data and prediction markets — no API keys, no signup. It's a separate project from Machina (built and maintained by Machina Sports), and this page only covers how it connects to Machina — see its own site/repo for the full skill catalog and API reference.

What it is

  • 25 skills covering major sports leagues (NFL, NBA, WNBA, NHL, MLB, football/soccer, tennis, CFB, CBB, golf, F1, volleyball, cricket, NCAA cross country & track and field), esports, prediction markets (Kalshi, Polymarket), betting math, sports news aggregation, and article generation.
  • Sources are all public (ESPN, Understat, FPL, official league/market APIs) — no licensed/commercial data providers.
  • Works with any Agent Skills-compatible harness: Claude Code, Cursor, Copilot, Gemini CLI, Windsurf, SportsClaw, and others.

Install

bash
# Via the Agent Skills registry (all skills)
npx skills add machina-sports/sports-skills

# A single skill
npx skills add machina-sports/sports-skills@nba-data

# As a Python package (CLI + SDK)
uv tool install sports-skills   # or: pip install sports-skills

Upgrading to Machina

Sports Skills ships a machina skill specifically for this: it teaches an agent how to install machina-cli and connect to the Machina Sports premium infrastructure — trading delayed, open-source static data for live streams, betting odds, and agent-ready templates.

bash
curl -fsSL https://raw.githubusercontent.com/machina-sports/machina-cli/main/install.sh | bash
# or: pip install machina-cli

machina login                        # or: machina login --api-key <project-api-key>
machina template list                 # browse pre-packaged workflow templates
machina template install <template-path>

Once authenticated, the skill's own guidance is explicit: don't hand-roll raw HTTP calls against the premium API — go through the Machina MCP server the CLI wires up, which handles tenant routing and live data streaming into the agent's context. See MCP and machina connect for that connection.

  • Machina CLI — what the upgrade path installs.
  • MCP — how a connected agent actually talks to a Machina project.
  • SportsClaw — an agent harness that bundles Sports Skills and can also connect to Machina.