Cbb Data

Pulls live college basketball data from ESPN's public endpoints with zero configuration. You get scores, standings, rankings, rosters, play-by-play, win probability charts, and March Madness futures for all 360+ Division I men's teams. The key difference from pro basketball skills is that standings are per-conference (you need to pass a conference ID), and rankings replace traditional leader boards. Season logic is built in: it knows CBB runs November through April and adjusts queries accordingly. No API keys, just install the CLI and start querying. Solid for March Madness dashboards or any CBB stats work where you don't want to deal with auth or rate limits.

skills.sh installs: 705
GitHub stars: 268
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add machina-sports/sports-skills --skill cbb-data --agent claude-code

Installs into .claude/skills of the current project.

Files

College Basketball Data (CBB)

Before writing queries, consult references/api-reference.md for endpoints, conference IDs, team IDs, and data shapes.

Setup

Before first use, check if the CLI is available:

which sports-skills || pip install sports-skills

If pip install fails with a Python version error, the package requires Python 3.10+. Find a compatible Python:

python3 --version  # check version
# If < 3.10, try: python3.12 -m pip install sports-skills
# On macOS with Homebrew: /opt/homebrew/bin/python3.12 -m pip install sports-skills

No API keys required.

Quick Start

Prefer the CLI — it avoids Python import path issues:

sports-skills cbb get_scoreboard
sports-skills cbb get_rankings
sports-skills cbb get_standings --group=23

CRITICAL: Before Any Query

CRITICAL: Before calling any data endpoint, verify:

Season year is derived from the system prompt's currentDate — never hardcoded.
For standings, the group parameter is set to the correct conference ID (see references/api-reference.md).
If only a team name is provided, use get_teams to resolve the team ID.