Agent skill · research science · machina-sports
cricket-data
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 registry (Cricsheet, ODC-BY 1.0). Zero config, no API keys. Use when: user asks about cricket scores, IPL/BBL/PSL/international series, points tables, match details, cricket news, ball-by-ball history, or player career stats. Don't use when: user asks about other sports — use football-data (soccer), nfl-data (NFL), nba-data (NBA), wnba-data (WNBA), nhl-data (NHL), mlb-data (MLB), tennis-data (tennis), golf-data (golf), cfb-data (college football), cbb-data (college basketball), or fastf1 (F1). For betting odds use polymarket or kalshi. For general news use sports-news. Don't use for ICC rankings — no free source exists (v1 limitation).
Why this skill is useful
Provides specific commands and ID conventions for accessing cricket data that the AI wouldn't generate on its own.
What it needs
About 4k tokens when loaded. Last updated 2026-08-06. 201 stars on the source repository.
What this skill does
Cricket Data (ESPN + Cricsheet) Before writing queries, consult references/api-reference.md for endpoints, ID conventions, and data shapes. See references/competitions.md for the Cricsheet competition codes. Quick Start Prefer the CLI — it avoids Python import path issues. There are two backends: ESPN (live-ish) and Cricsheet (historical). CRITICAL: Before Any Query CRITICAL: Before calling any data endpoint, verify: ESPN series IDs are per-series, not per-league. Always discover them with getseries first. IDs change every season for recurring tournaments (e.g. each IPL season has a different ID). Never hardcode them — the 8048 in the examples is illustrative, not permanent. Two ID spaces. getseries returns ESPN IDs (live, numeric, e.g. 8048). getcompetitions returns Cricsheet codes (historical, letter codes, e.g. ipl). They are unrelated except at the match level: a Cricsheet matchid equals the ESPNcricinfo match ID, so it bridges the two backends. Cricsheet covers completed matches only (~1-day lag after a match finishes). For anything live or upcoming, use the ESPN commands (getscoreboard, getseries). getplayerstats requires the exact Cricsheet name spelling (e.g. "V Kohli", not "Virat Kohli"). Resolve the spelling with findplayer first. No ICC rankings — there is no free source (v1 limitation). Series standings come from getstandings, which is empty for most bilateral tours (only league/group tournaments publish a points table). First Cricsheet call per competition per day downloads a zip. Large competitions (Tests, ODIs, IPL) are tens of MB. Zips are cached 24h at ~/.cache/sports-skills/cricsheet/; later calls in the same day are fast. Agents can run scripts/validateparams.sh to pre-validate --competition, --seriesid, and --date before querying. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills machina-sports/cricket-data