Menu
Add a Fox Sports (Bifrost) league/sport — capture + catalog in sdv-internal-refs/fox.
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
| name | sdv-add-fox-league |
| description | Add a Fox Sports (Bifrost) league/sport — capture + catalog in sdv-internal-refs/fox. |
| disable-model-invocation | true |
Adds a new sport or league to the Fox Sports (Bifrost) catalog in sdv-internal-refs. The Bifrost API is uniform across all sports — one OpenAPI spec governs every endpoint. This skill covers capture + catalog only (no sdv-py wrappers yet; Fox is not currently wired into sdv-py codegen).
| Property | Value |
|---|---|
| Base URL | https://api.foxsports.com/bifrost/v1 |
| Auth | apikey=<key> + api-version=<ver> as query params (public, no account) |
| OpenAPI spec | c:\Users\saiem\Documents\GitHub-Data\sdv-dev\sdv-swagger\foxsports-api-openapi.yaml |
| Body captures | c:\Users\saiem\Documents\sdv-internal-refs\fox\inputs\sample_bodies\ |
The {sport} slug is a path segment. Example: hockey, basketball, football, baseball, soccer, golf, tennis, mma.
These are the surfaces defined in the OpenAPI spec. All are parameterized on {sport}:
| Category | Path pattern | Notes |
|---|---|---|
| Scoreboard | /{sport}/scoreboard | Event list with scores |
| League hub | /{sport}/league/{leagueId}/teamnav | Team nav |
| League hub | /{sport}/league/{leagueId}/standings | Standings |
| League hub | /{sport}/league/{leagueId}/conferences | Conferences |
| League hub | /{sport}/league/{leagueId}/polls | AP/Coaches polls |
| League hub | /{sport}/league/{leagueId}/stats-con | Stats |
| League hub | /{sport}/league/{leagueId}/odds | Odds hub |
| Event | /{sport}/event/{eventId}/data | Full event data |
| Event | /{sport}/event/{eventId}/matchup | Matchup |
| Event | /{sport}/event/{eventId}/recap | Recap |
| Event | /{sport}/event/{eventId}/odds | Event odds |
| Team | /{sport}/team/{teamId}/roster | Roster |
| Team | /{sport}/team/{teamId}/stats | Stats |
| Team | /{sport}/team/{teamId}/gamelog | Game log |
| Team | /{sport}/team/{teamId}/standings | Standings |
| Team | /{sport}/team/{teamId}/header | Team header |
| Search | /search | Cross-sport search |
| Explore | /{sport}/explore | Explore hub |
| Trending | /{sport}/trending | Trending content |
Look at existing captures in fox/inputs/sample_bodies/ for naming conventions (e.g. football/nfl/, basketball/nba/). The leagueId is visible in the Fox Sports web UI URL or in an existing scoreboard response.
fox/inputs/sample_bodies/<sport>/<league>/scoreboard.json
fox/inputs/sample_bodies/<sport>/<league>/standings.json
fox/inputs/sample_bodies/<sport>/<league>/event_data.json
fox/inputs/sample_bodies/<sport>/<league>/team_roster.json
Fetch manually with curl or httpx. Example:
API_KEY="<your-key>"
API_VER="<version>"
SPORT="hockey"
LEAGUE_ID="<leagueId>"
curl -s "https://api.foxsports.com/bifrost/v1/$SPORT/league/$LEAGUE_ID/standings?apikey=$API_KEY&api-version=$API_VER" \
| python -m json.tool > fox/inputs/sample_bodies/$SPORT/$LEAGUE_ID/standings.json
Capture at minimum: scoreboard, standings, one event/data, one team/roster.
Create fox/catalogs/<sport>_<league>_returns.md:
# Fox Sports Bifrost — <Sport> <League> Returns
Captured: YYYY-MM-DD
Sport slug: `<sport>`
League ID: `<leagueId>`
## scoreboard
**URL:** `https://api.foxsports.com/bifrost/v1/<sport>/scoreboard?...`
**Top-level keys:** `["games", "league", "date", ...]`
| Field | Type | Notes |
|---|---|---|
| games[].id | string | |
| games[].status | string | |
...
## standings
...
## Divergence notes
- <any shape differences vs other Fox leagues>
Open fox/fox_catalog.yaml and add the new entry:
- sport: <sport>
league: <league-label>
league_id: <leagueId>
surfaces_captured:
- scoreboard
- standings
- event_data
- team_roster
capture_date: YYYY-MM-DD
returns_doc: catalogs/<sport>_<league>_returns.md
apikey is a public browser key observable in network traffic on foxsports.com. It is not a secret but may rotate; keep a note of the version you used.{sport}/league/{leagueId}/polls endpoints 404 for leagues that do not have polls (e.g. minor leagues). Document as absent rather than retrying.event/{eventId}/odds may be empty before lines are posted. Capture a pre-game body closer to kickoff.sdv-swagger/foxsports-api-openapi.yaml for the authoritative schema; the OpenAPI is the source of truth if a response shape is ambiguous.Use when porting R logic into the Python SportsDataverse package (sdv-py) — e.g. translating an nflfastR / cfbfastR / cfbscrapR / baseballr / hoopR R function, reconciling a fix from the pandas `0.36-live` branch into polars `main`, or re-implementing a modeling recipe (EP/WP/QBR/CPOE) from R. Enforces a parity-test-first workflow (golden fixture from the R output → failing parity test → port → green) and the polars-1x + ID-dtype + no-lookaround conventions. Also covers R numeric fidelity when outputs must match R bit-for-bit (R>=4.0 fround, 80-bit long-double sum, non-na.rm null-poisoning, dplyr group order), stale-fork sibling packages (wbigballR-style), and oracle integrity (a browser/rvest-captured oracle can be corrupt — fix the bug, don't match it). Invoke for "port this R function to polars", "port from nflfastR/bigballR", "reconcile 0.36-live into main", "translate this dplyr/np.select to polars", "re-implement the R model recipe in Python", or when a parity test fails on a handful of rounding-boundar
Use when shipping a change in sportsdataverse-py (sdv-py) — opening, pushing, or merging a PR. Runs the steps in the correct order (regenerate codegen docs, update changelog/docs/tutorials, lint, full pytest, commit + verify it landed, push, triage bot reviews CodeRabbit/Sourcery/Copilot immediately — in parallel with CI, not after it — wait for CI green, confirm merge, write a session note) and never cleans up a branch before the merge is confirmed. Invoke for "ship this", "open/merge the PR", "land this change", or any end-of-change release flow.
Use when executing a model-spine implementation plan (the ClaudeCowork specs/plans backlog — prediction stacks, ratings engines, projection/impact models) or building any oracle-gated analytics module in an SDV repo. Covers the full loop — isolated worktree + baseline, Phase-0 oracle harness (metrics/constants/leakage split/fixtures), per-task TDD with verified commits, oracle gates with the never-lower rule, league-shim parity, mypy/codegen close-out, reviewer pass, and the session restart prompt. Invoke for "implement T<x>", "start the <sport> model spine", "continue the prediction stack", or any multi-phase model build.
Use when capturing an external oracle/validation corpus into committed test fixtures — Torvik/KenPom ratings, ESPN BPI/predictor/odds, market closing lines, MoneyPuck, published RAPM/EPM, or any third-party reference a model gate will assert against. Covers column contracts, Utf8-id discipline, the team/player name-crosswalk recipe (contracting normalizer + candidate keys + alias table + match-rate reporting), rate-limit-aware sampling, and the mandatory provenance README. Invoke for "capture the oracle corpus", "commit the <source> fixtures", or any Task-0-style fixture capture in a model plan.
Use when porting Python logic from the SportsDataverse Python package (sdv-py) into a SportsDataverse R package — cfbfastR, hoopR, wehoop, baseballr, fastRhockey, softballR, etc. Enforces a parity-test-first workflow (golden fixture from the Python output → failing testthat test → port → green) plus the tidyverse/data.table idiom map and R package conventions (roxygen2 docs, snake_case, tibble returns, pkgdown reference coverage). Invoke for "port this to cfbfastR", "translate this polars logic to dplyr", "re-implement the sdv-py parser in R", or "bring this Python fix back to the R package".
Add a CBS Sports (NAPI) league/resource — capture + catalog in sdv-internal-refs/cbs.