Nfl Data

Pulls NFL data from ESPN's public endpoints plus nflverse tables for schedules, rosters, play-by-play, and normalized stats. No API keys, zero config. You get live scores, standings, injury reports, depth charts, box scores, and full play-by-play with EPA and win probability. The nflverse backend gives you clean tabular data if you need to do your own analysis or aggregations. Season detection is built in (it knows the NFL calendar runs September through February), and there's a CLI so you don't fight Python import paths. Honestly feels like the kind of tool someone built because they got tired of scraping ESPN themselves.

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

View on GitHub

Install

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

Installs into .claude/skills of the current project.

Files

NFL 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:

which sports-skills || pip install sports-skills

If pip install fails (package not found or Python version error), install from GitHub:

pip install git+https://github.com/machina-sports/sports-skills.git

The package requires Python 3.10+. If your default Python is older, use a specific version:

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.

For nflverse-backed commands (get_nflverse_*), install the NFL extra:

pip install sports-skills[nfl]

On Python 3.10+ this installs nflreadpy (the preferred backend) plus pyarrow, which is needed for most nflverse data beyond schedules. On Python 3.9 it installs nfl-data-py instead, since nflreadpy requires 3.10+.

SKILL.md on GitHub