Cfb Data

Pulls live college football data from ESPN's public endpoints without any API keys or setup. You get scores, standings by conference, rankings (AP Top 25, Coaches Poll, CFP), play-by-play, rosters, schedules, injuries, and futures markets for all FBS teams. The skill handles the quirks of college ball: week-based schedules, conference-specific standings using group IDs, and ranked team indicators on scoreboards. It automatically derives the correct season year from the current date, accounting for the August to January season window. Useful when you need quick CFB data without wrestling with authentication or rate limits. Ships with reference docs for conference IDs and team lookups.

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

View on GitHub

Install

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

Installs into .claude/skills of the current project.

Files

College Football Data (CFB)

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 cfb get_scoreboard
sports-skills cfb get_rankings
sports-skills cfb get_standings --group=8

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.