菜单
Add a league/source for ANY SportsDataverse provider (ESPN, Fox Bifrost, CBS NAPI, Yahoo, 247Sports, Torvik) — capture bodies, generate the returns doc, extend the catalog, scaffold the wrapper.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
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.
| name | sdv-add-provider-source |
| description | Add a league/source for ANY SportsDataverse provider (ESPN, Fox Bifrost, CBS NAPI, Yahoo, 247Sports, Torvik) — capture bodies, generate the returns doc, extend the catalog, scaffold the wrapper. |
| disable-model-invocation | true |
Router skill. Identify the provider first, then follow the matching sub-flow. All providers share a common Part A (capture + catalog in sdv-internal-refs) before any sdv-py wiring.
| Provider | Skill | Base URL | Auth |
|---|---|---|---|
| ESPN | sdv-add-espn-league + sdv-add-sport-parser | site.api.espn.com / sports.core.api.espn.com | None (public) |
| Fox Sports (Bifrost) | sdv-add-fox-league | api.foxsports.com/bifrost/v1 | apikey + api-version query params |
| CBS Sports (NAPI) | sdv-add-cbs-league | api.cbssports.com/napi | None for data resources |
| Yahoo Sports | sdv-add-yahoo-source | sports.yahoo.com (HTML scrape) | None (scrape) |
| 247Sports | See below | 247sports.com | None (HTML scrape) |
| Barttorvik | See below | barttorvik.com | None (CSV/JSON endpoints) |
For ESPN → use sdv-add-espn-league (wrapper registration) and sdv-add-sport-parser (parser layer). This skill does not repeat those steps.
Working dir: c:\Users\saiem\Documents\sdv-internal-refs
Create the directory structure:
<provider>/inputs/sample_bodies/<sport-or-league>/<endpoint>.json
Fetch and save bodies manually or via a helper script. Record:
YYYY-MM-DD)Create <provider>/catalogs/<sport>_returns.md:
# <Provider> — <Sport/League> Returns
Captured: YYYY-MM-DD
## <endpoint-name>
**URL:** `https://...`
**Host:** `api.provider.com`
**Top-level keys:** `["events", "season", ...]`
| Field | Type | Notes |
|---|---|---|
| id | string | |
| ...
**Divergence notes:** ...
Each provider directory has a master catalog file (e.g. fox/fox_catalog.yaml, cbs/cbs_catalog.yaml). Add your new sport/league entry following the existing schema.
→ Follow sdv-add-espn-league for wrapper registration.
→ Follow sdv-add-sport-parser for the parser layer.
→ Follow sdv-add-fox-league. The OpenAPI at c:\Users\saiem\Documents\GitHub-Data\sdv-dev\sdv-swagger\foxsports-api-openapi.yaml covers the full Bifrost surface.
→ Follow sdv-add-cbs-league. Regenerate the OpenAPI with python cbs/gen_napi_openapi.py after capturing new resources.
→ Follow sdv-add-yahoo-source. Extracting the embedded JSON blob is the critical first step.
247Sports serves content as HTML with embedded JSON in <script id="__NEXT_DATA__"> (Next.js). Steps:
<provider>/inputs/sample_bodies/247sports/<sport>/<page>.htmlJSON.parse(document.getElementById('__NEXT_DATA__').textContent) or equivalent Python BeautifulSoup + json.loads extraction.Barttorvik exposes clean CSV/JSON endpoints (no auth). The barttorvik catalog in sdv-internal-refs maps the known endpoints. Steps:
https://barttorvik.com/<endpoint>.json?... or ...csv.barttorvik/inputs/sample_bodies/<endpoint>.json.sportsdataverse/mbb/ (Torvik-backed functions). Check the existing surface before adding a new one — the function may already exist.espn_<league>_<dataset>(...) returning pl.DataFrame.feat(<provider>): add <sport/league> capture + catalog
feat(<prefix>): scaffold <provider> <sport> wrappers
No Co-Authored-By trailers.