Agent skill · data analytics · machina-sports
cfb-data
College Football (CFB) data via ESPN public endpoints and the NCAA's official endpoints — scores, standings, rosters, schedules, game summaries, play-by-play, rankings, injuries, futures, team/player stats, and news for FBS, plus official FCS scoreboards, NCAA game detail with drive context, and the schools index. Zero config, no API keys. Use when: user asks about college football scores, standings, rankings, team rosters, schedules, game results, play-by-play, injuries, betting futures, team/player statistics, CFB news, or FCS games. Don't use when: user asks about NFL (use nfl-data), college basketball (use cbb-data), or non-sports topics.
Why this skill is useful
Provides access to niche college football data and specific API commands that the AI wouldn't reliably generate on its own.
What it needs
About 6k tokens when loaded. Last updated 2026-08-06. 201 stars on the source repository.
What this skill does
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: 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. 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 getteams to resolve the team ID. Choosing the Season Derive the current year from the system prompt's date (e.g., currentDate: 2026-02-28 → 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 CFB season runs August–January. If the current month is February–July (offseason), use season = currentyear - 1. From August onward, use the current year. Important: College vs. Pro Differences Standings are per-conference — use the group parameter to filter Rankings replace leaders — college uses AP Top 25, Coaches Poll, and CFP rankings Ranked teams have a rank field (null = unranked) on scoreboard competitors Week-based schedule — like NFL, college football uses week numbers Commands Command Description --- --- getscoreboard Live/recent college football scores getstandings Standings by conference (use group parameter) getteams All 750+ FBS college football teams getteamroster Full roster for a team getteamschedule Schedule for a specific team getgamesummary Detailed box score and scoring plays getrankings AP Top 25, Coaches Poll, CFP rankings getnews College football news getplaybyplay Full play-by-play for a game getwinprobability Win probability timeline for a completed game getschedule Season schedule …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills machina-sports/cfb-data