> ## Documentation Index
> Fetch the complete documentation index at: https://docs.machina.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# Sports Skills

> The free, open-source sports-data layer that upgrades to Machina via machina-cli and MCP.

[Sports Skills](https://sports-skills.sh) 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

* 20 skills covering major sports leagues (NFL, NBA, WNBA, NHL, MLB, football/soccer, tennis, CFB, CBB, golf, F1, volleyball, cross country), prediction markets (Kalshi, Polymarket), betting math, and sports news aggregation.
* 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 theme={null}
# 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 theme={null}
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](/mcp/overview) and [`machina connect`](/cli/commands/connect) for that connection.

## Related

* [Machina CLI](/cli/guide/installation) — what the upgrade path installs.
* [MCP](/mcp/overview) — how a connected agent actually talks to a Machina project.
* [SportsClaw](/ecosystem/sportsclaw) — an agent harness that bundles Sports Skills and can also connect to Machina.