Agent skill · data analytics · machina-sports
nba-data
NBA data via ESPN public endpoints, the NBA live CDN, and NBA Stats (stats.nba.com) — scores, standings, rosters, schedules, game summaries, play-by-play, injuries, futures, depth charts, leaders, and news, plus an analytics backend: advanced ratings, per-shot court coordinates, career splits, and history to 1946. Zero config, no API keys. Use when: user asks about NBA scores, standings, team rosters, schedules, game stats, box scores, play-by-play, injuries, transactions, betting futures, depth charts, team/player statistics, NBA news, shot charts, advanced ratings/pace, career stats, or historical NBA seasons. Don't use when: user asks about WNBA (use wnba-data), college basketball (use cbb-data), or other sports.
Why this skill is useful
Provides access to niche NBA data endpoints and analytics that the AI wouldn't reliably generate on its own.
What it needs
Requires sports-skills installed locally. About 5k tokens when loaded. Last updated 2026-08-06. 201 stars on the source repository.
What this skill does
NBA Data Before writing queries, consult references/api-reference.md for endpoints, ID conventions, and data shapes. Setup Before first use, check if the CLI is available: If pip install fails with a Python version error, the package requires Python 3.10+. Find a compatible Python: No API keys required. Quick Start Prefer the CLI — it avoids Python import path issues: CRITICAL: Before Any Query CRITICAL: Before calling any data endpoint, verify: Season year is derived from the system prompt's currentDate — never hardcoded. If only a team name is provided, call getteams to resolve the team ID before using team-specific commands. Choosing the Season Derive the current year from the system prompt's date (e.g., currentDate: 2026-02-18 → current year is 2026). If the user specifies a season, use it as-is. If the user says "current", "this season", or doesn't specify: The NBA season runs October–June. If the current month is October–December, the active season year matches the current year. If January–June, the active season started the previous calendar year (use that year as the season). Commands Command Description --- --- getscoreboard Live/recent NBA scores getstandings Standings by conference getteams All 30 NBA teams getteamroster Full roster for a team getteamschedule Schedule for a specific team getgamesummary Detailed box score and scoring plays getleaders NBA statistical leaders getnews NBA news articles getplaybyplay Full play-by-play for a game getwinprobability Win probability chart data getschedule Schedule for a specific date or season getinjuries Injury reports across all teams gettransactions Recent transactions getfutures Futures/odds markets getdepthchart Depth chart for a team getteamstats Team statistical profile getplayerstats Player statistical profile findnbaplayer Search the NBA Stats player registry (all eras) getnbastatsgamelog League game log via NBA Stats — history to 1946, carries NBA game ids getnbastatsplayercareer Career stats season by s …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills machina-sports/nba-data