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…

MITAuto-check passedData & Analytics

Install Cfb Data

skills CLI
$ npx skills add machina-sports/sports-skills --skill cfb-data -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install machina-sports/sports-skills cfb-data --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/machina-sports/sports-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/cfb-data .claude/skills/cfb-data && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
cfb-data
GitHub stars
245
Token cost
~2.9k tokens
SKILL.md length
909 words
Files
5 (incl. scripts, references)
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

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…

  • Works in 2 steps: Derive season year from currentDate → Call get_standings(group=8, season=)…
  • : user asks about college football scores
  • SKILL.md covers Setup, Quick Start, CRITICAL: Before Any Query and Choosing the Season, plus 7 more sections
  • Runs Shell scripts from its folder; calls pip and python3

What it does

Cfb Data is an agent skill from machina-sports/sports-skills. 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…

Its SKILL.md is about 2.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `references/api-reference.md`, `references/conference-ids.md` and `references/team-ids.md`).

It sits in Data & Analytics, covering Statistics. It works with Python. The repository describes itself as: Open-source agent skills for live sports data and prediction markets. Football, F1, Kalshi, Polymarket. Zero API keys. SKILL.md format. The licence is MIT.

When your agent uses it

  • : user asks about college football scores
  • Betting futures
  • Team/player statistics
  • : user asks about NFL (use nfl-data)

Example prompts

  • “/cfb-data”

Requirements

  • Python 3
  • A Bash shell

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Derive season year from currentDate
  2. Call get_standings(group=8, season=) (group 8 = SEC)

What it can do on your machine

Read from SKILL.md and the folder at commit 0420a7c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • pip
    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Cfb Data loads about 2.9k tokens when it runs, and up to ~4.7k if it reads all its reference files. Until then it costs about 165 tokens; SKILL.md has 909 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~165
When it runs · the whole SKILL.md, loaded when a task matches
~2.9k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from machina-sports/sports-skills at commit 0420a7c, republished under its MIT licence (© machina-sports). 909 words, ~2,935 tokens.

Download SKILL.mdSave it as .claude/skills/cfb-data/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
cfb-data
description
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.
license
MIT
metadata.author
machina-sports
metadata.version
0.1.0

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:

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

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

bash
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.

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 = current_year - 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

CommandDescription
get_scoreboardLive/recent college football scores
get_standingsStandings by conference (use group parameter)
get_teamsAll 750+ FBS college football teams
get_team_rosterFull roster for a team
get_team_scheduleSchedule for a specific team
get_game_summaryDetailed box score and scoring plays
get_rankingsAP Top 25, Coaches Poll, CFP rankings
get_newsCollege football news
get_play_by_playFull play-by-play for a game
get_win_probabilityWin probability timeline for a completed game
get_scheduleSeason schedule by week
get_injuriesInjury reports across all teams
get_futuresFutures/odds markets (National Championship, Heisman, etc.)
get_team_statsTeam statistical profile
get_player_statsPlayer statistical profile
get_ncaa_scoreboardOfficial NCAA scoreboard — FBS and FCS
get_ncaa_scheduleWhich weeks have games (official index)
get_ncaa_gameOfficial NCAA game information
get_ncaa_boxscoreOfficial NCAA box score
get_ncaa_play_by_playOfficial play-by-play with drive context
get_ncaa_scoring_summaryOfficial scoring summary
get_ncaa_schoolsNCAA schools index (all divisions)

See references/api-reference.md for full parameter lists and return shapes.

Official NCAA Backend

The get_ncaa_* commands read the NCAA's own endpoints (sdataprod.ncaa.com + ncaa.com) — coverage ESPN does not carry:

  • FCS scoreboards via division="fcs" — ESPN's college coverage is FBS-centric.
  • Official game detail: get_ncaa_game, get_ncaa_boxscore, get_ncaa_play_by_play (with drive context), get_ncaa_scoring_summary.
  • The schools index (~1,200 schools, all divisions): get_ncaa_schools.

NCAA game ids (e.g. 6306261, from get_ncaa_scoreboard) and ESPN event ids share nothing — join on game date plus team names. NCAA reissues game ids, so take them from a fresh get_ncaa_scoreboard call rather than storing them. Football divisions are fbs/fcs (not d1-d3). get_ncaa_schedule numbers the weeks get_ncaa_scoreboard takes (16+ are the postseason, FCS playoffs included). Scoring-summary field goals carry distance_yards, taken from the play-by-play. All get_ncaa_* commands except get_ncaa_schools ride NCAA's GraphQL persisted queries, whose hashes rotate when ncaa.com redeploys; when that happens they say so explicitly, and the ESPN-backed get_scoreboard / get_schedule cover the same FBS games.

Show full SKILL.md (406 more words)Show less

Examples

Example 1: Current rankings User says: "What are the college football rankings?" Actions:

  1. Call get_rankings() Result: AP Top 25, Coaches Poll, and CFP rankings with rank, previous rank, record

Example 2: Conference standings User says: "Show me SEC football standings" Actions:

  1. Derive season year from currentDate
  2. Call get_standings(group=8, season=<derived_year>) (group 8 = SEC) Result: SEC standings with W-L records per team

Example 3: Team schedule User says: "What's Alabama's schedule this season?" Actions:

  1. Derive season year from currentDate
  2. Call get_team_schedule(team_id="333", season=<derived_year>) Result: Alabama's full season schedule with opponent, date, score (if played)

Example 4: Weekly scores User says: "Show me this week's college football scores" Actions:

  1. Call get_scoreboard() Result: All live and recent CFB games with scores and ranked status

Example 5: Heisman favorites User says: "Who's the Heisman favorite?" Actions:

  1. Call get_futures(limit=10) Result: Top Heisman Trophy candidates with odds values

Example 6: Team statistics User says: "Show me Alabama's team stats" Actions:

  1. Derive season year from currentDate
  2. Call get_team_stats(team_id="333", season_year=<derived_year>) Result: Alabama's season stats by category with value, rank, and per-game averages

Commands that DO NOT exist — never call these

  • get_odds / get_betting_odds — not available. For prediction market odds, use the polymarket or kalshi skill.
  • search_teams — does not exist. Use get_teams instead.
  • get_box_score — does not exist. Use get_game_summary instead.
  • get_player_ratings — does not exist. Use get_player_stats instead.
  • get_bcs_rankings / get_playoff_rankings — does not exist. Use get_rankings instead.

If a command is not listed in the Commands table above, it does not exist.

Error Handling

When a command fails, do not surface raw errors to the user. Instead:

  1. If no events found for a date, check if it's in the off-season (CFB runs August–January)
  2. If standings are empty without a group filter, try with a specific conference group
  3. Only report failure with a clean message after exhausting alternatives

Troubleshooting

Error: sports-skills command not found Cause: Package not installed Solution: Run pip install sports-skills

Error: No games found Cause: CFB is seasonal (August–January); off-season scoreboard will be empty Solution: Use get_rankings or get_news year-round; use get_schedule to find when the season starts

Error: Too many teams returned Cause: get_teams returns 750+ FBS teams Solution: Help users narrow down by suggesting specific team IDs from references/api-reference.md, or use ESPN URLs to look up IDs

Error: Rankings empty in off-season Cause: Rankings are only published during the season and early off-season Solution: Use get_news in the offseason; rankings resume in August

© machina-sports, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (scripts, references) in skills/cfb-data of machina-sports/sports-skills.

  • SKILL.md
  • references/api-reference.md
  • references/conference-ids.md
  • references/team-ids.md
  • scripts/validate_params.sh

Open the folder on GitHubat commit 0420a7c

Compare with similar skills

Cfb Data next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Cfb Data compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cfb Data this skillmachina-sports/sports-skills245—~2.9kAutomated safety check: PassMIT
StatsmodelszLanqing/codex-claude-academic-skills4.7k15 repos~4.9kAutomated safety check: PassBSD-3-Clause
Rota Bench Regression Analysisoracle/graalpython1.7k—~1.6kAutomated safety check: PassCustom licence
MatlabzLanqing/codex-claude-academic-skills4.7k8 repos~2.3kAutomated safety check: NotesGPL-3.0
Meridian MMM Model Buildinggoogle/meridian1.6k—~2.5kAutomated safety check: PassApache-2.0
Statistical Data Analysislingzhi227/agent-research-skills390—~886Automated safety check: PassNone

Similar skills

  • Statsmodels

    zLanqing/codex-claude-academic-skills

    Statistical models library for Python. An agent skill from zLanqing/codex-claude-academic-skills.

    4.7k GitHub starsUsed in 15 repos~4.9k tokens
    Data & AnalyticsAuto-check passed
  • Official

    Analyze recent GraalPy benchmark regressions on master as part of the weekly rota.

    1.7k GitHub stars~1.6k tokensUpdated yesterday
    Data & AnalyticsAuto-check passed
  • Matlab

    zLanqing/codex-claude-academic-skills

    MATLAB and GNU Octave numerical computing for matrix operations, data analysis, visualization, and scientific computing.

    4.7k GitHub starsUsed in 8 repos~2.3k tokens
    Data & AnalyticsAuto-check: notes
  • Official

    Takes a user through building a Meridian marketing mix model, from loading CSV data and mapping columns to running EDA, fitting and saving the model.

    1.6k GitHub stars~2.5k tokensUpdated yesterday
    Data & AnalyticsAuto-check passed
  • Statistical Data Analysis

    lingzhi227/agent-research-skills

    Writes statistical analysis code for experimental data, runs it through a four-round review, and reports effect sizes, p-values and confidence intervals.

    390 GitHub stars~886 tokensUpdated 7 mo ago
    Data & AnalyticsAuto-check passed
  • UI Remote

    jetperch/pyjoulescope_ui

    Attach to and drive the running Joulescope UI via its --tcp-server remote-control interface.

    111 GitHub stars~1.7k tokensUpdated 2 days ago
    Data & AnalyticsAuto-check passed

More from machina-sports/sports-skills

All 23 skills in this repo
  • Cbb Data

    machina-sports/sports-skills

    College Basketball (CBB) data via ESPN public endpoints and the NCAA's official endpoints — scores, standings, rosters, schedules, game summaries, play-by-play, win probability, rankings, futures…

    245 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Cricket Data

    machina-sports/sports-skills

    Cricket data via ESPN public endpoints and Cricsheet open data — live-ish series scoreboards, standings, match summaries and news (ESPN), plus historical ball-by-ball, player stats, and player…

    245 GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Fastf1

    machina-sports/sports-skills

    Formula 1 data — race schedules, results, lap timing, driver and team info.

    245 GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Golf Data

    machina-sports/sports-skills

    PGA Tour, LPGA, and DP World Tour golf data via ESPN public endpoints — tournament leaderboards, scorecards, season schedules, golfer profiles/overviews, and news.

    245 GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Kalshi

    machina-sports/sports-skills

    Kalshi prediction markets — events, series, markets, trades, and candlestick data.

    245 GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Mlb Data

    machina-sports/sports-skills

    MLB data via ESPN public endpoints and the official MLB Stats API — scores, standings, rosters, schedules, game summaries, injuries, leaders, and news, plus an analytics backend: pitch-level…

    245 GitHub stars~2.6k tokensUpdated today
    Auto-check passed

Works with

Questions about Cfb Data

What does Cfb Data do?

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…. Cfb Data is an agent skill from machina-sports/sports-skills. 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.

When should I use Cfb Data?

Cfb Data fits situations like: : user asks about college football scores; betting futures; team/player statistics; : user asks about NFL (use nfl-data).

How do I install Cfb Data in Claude Code?

Run `npx skills add machina-sports/sports-skills --skill cfb-data -a claude-code`. Or copy the skill folder (skills/cfb-data in machina-sports/sports-skills) into .claude/skills/cfb-data in your project. Claude Code loads it when a task matches its description.

How do I install Cfb Data in Codex?

Run `npx skills add machina-sports/sports-skills --skill cfb-data -a codex`. Or copy the skill folder (skills/cfb-data in machina-sports/sports-skills) into .agents/skills/cfb-data in your project. Codex loads it when a task matches its description.

Can I use Cfb Data in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add machina-sports/sports-skills --skill cfb-data -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cfb-data, .gemini/skills/cfb-data, .github/skills/cfb-data and .opencode/skills/cfb-data in your project.

What does Cfb Data need to run?

Going by SKILL.md and its folder, Cfb Data needs a shell for the scripts in its folder and the command-line tools its instructions call (pip and python3). Our summary lists: Python 3; A Bash shell.

Does Cfb Data access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Cfb Data safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Cfb Data use?

Cfb Data is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Cfb Data use?

About 2.9k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.8k tokens, read only when the agent opens those files.

What are the alternatives to Cfb Data?

Skills that share tags, products or a category with Cfb Data: Statsmodels (zLanqing/codex-claude-academic-skills, 4.7k stars), Rota Bench Regression Analysis (oracle/graalpython, 1.7k stars), Matlab (zLanqing/codex-claude-academic-skills, 4.7k stars) and Meridian MMM Model Building (google/meridian, 1.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cfb Data?

machina-sports (a GitHub organization) maintains it in machina-sports/sports-skills, which has 245 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on October 10, 2026.

Source: machina-sports/sports-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.