Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →MLB data via ESPN public endpoints — scores, standings, rosters, schedules, game summaries, play-by-play, win probability, injuries, transactions, depth charts, team/player stats, leaders, and news. Zero config, no API keys. Use when: user asks about MLB scores, standings, team rosters, schedules, game stats, box scores, play-by-play, injuries, transactions, depth charts, team/player statistics, or MLB news. Don't use when: user asks about minor league baseball, college baseball, or internation
.claude/skills/machina-sports-mlb-data/SKILL.md| Test case | Without → With | Effect | Δ tokens | Δ turns |
|---|---|---|---|---|
| case-05 | ✗→✓ | ▲ Improved | 158% | 0% |
| case-06 | ✗→✓ | ▲ Improved | 117% | 0% |
| case-07 | ✗→✓ | ▲ Improved | 139% | 0% |
| case-08 | ✗→✓ | ▲ Improved | 159% | 0% |
| case-11 | ✗→✓ | ▲ Improved | 115% | 0% |
Before writing queries, consult references/api-reference.md for endpoints, ID conventions, and data shapes.
Before first use, check if the CLI is available:
bashwhich 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:
bashpython3 --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.
Prefer the CLI — it avoids Python import path issues:
bashsports-skills mlb get_scoreboard sports-skills mlb get_standings --season=2025 sports-skills mlb get_teams
CRITICAL: Before calling any data endpoint, verify:
currentDate — never hardcoded.get_teams to resolve the team ID before using team-specific commands.Derive the active season from the system prompt's date — not just the calendar year.
| Command | Description | |---|---| | get_scoreboard | Live/recent MLB scores | | get_standings | Standings by league and division | | get_teams | All 30 MLB teams | | get_team_roster | Full roster for a team | | get_team_schedule | Schedule for a specific team | | get_game_summary | Detailed box score and scoring plays | | get_leaders | MLB statistical leaders | | get_news | MLB news articles | | get_play_by_play | Full play-by-play for a game | | get_win_probability | Win probability chart data | | get_schedule | Schedule for a specific date or season | | get_injuries | Injury reports across all teams | | get_transactions | Recent transactions | | get_depth_chart | Depth chart for a team | | get_team_stats | Team statistical profile | | get_player_stats | Player statistical profile | | find_mlb_player | Search MLB's player registry by name | | get_mlbstats_schedule | Games via the MLB Stats API — history to 1901, carries gamePk ids | | get_mlbstats_player_stats | Season/career/year-by-year splits by stat group via MLB Stats API | | get_mlbstats_play_by_play | Pitch-level PBP — velocity, spin, plate coords, exit velo, launch angle | | get_mlbstats_boxscore | Full box score with per-player batting/pitching via MLB Stats API | | get_mlbstats_standings | Standings by division via MLB Stats API | | get_mlbstats_leaders | League leaders for any stat category via MLB Stats API |
See references/api-reference.md for full parameter lists and return shapes.
The get_mlbstats_* commands read statsapi.mlb.com — MLB's own open API. It carries the analytics layer ESPN does not: per-pitch velocity/spin/location, exit velocity and launch angle on balls in play, career splits by stat group, and schedules back to 1901. The two sources use unrelated id systems:
gamePk (e.g. 775296); ESPN uses event ids(e.g. 401570367). No shared column — join on the game date plus teams.
ARI/CHW vs MLB AZ/CWS.Every get_mlbstats_* team filter accepts either spelling, and rows carry both (team_abbreviation, team_abbreviation_espn).
660271) and ESPN athlete ids are unrelated.Resolve names with find_mlb_player; ASCII spellings match accented names ("acuna" finds "Ronald Acuña Jr.").
homeRuns exists for hitting,catching, and pitching (home runs allowed); rows are labelled with stat_group — pass stat_group= to get just one.
Responses include MLB's copyright notice, passed through from the API.
Example 1: Today's scores User says: "What are today's MLB scores?" Actions:
get_scoreboard()Result: All live and recent MLB games with scores by inning and status
Example 2: Division standings User says: "Show me the AL East standings" Actions:
currentDateget_standings(season=<derived_year>)Result: AL East standings with W-L, PCT, GB, run differential
Example 3: Team roster User says: "Who's on the Yankees roster?" Actions:
get_team_roster(team_id="10")Result: Full Yankees roster with name, position, bats/throws, height, weight
Example 4: Game box score User says: "Show me the full box score for last night's Dodgers game" Actions:
get_scoreboard(date="<yesterday>") to find the event_idget_game_summary(event_id=<id>) for full box scoreResult: Complete box score with batting/pitching stats per player
Example 5: Injury report User says: "Who's on the IL for the Yankees?" Actions:
get_injuries()Result: Yankees IL list with player name, position, IL type, and injury detail
Example 6: Player statistics User says: "Show me Shohei Ohtani's stats" Actions:
currentDateget_player_stats(player_id="39832", season_year=<derived_year>)Result: Season stats by category (batting, pitching) with value, rank, and per-game averages
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.If a command is not listed in the Commands table above, it does not exist.
When a command fails, do not surface raw errors to the user. Instead:
get_teams to find the ID firstError: sports-skills command not found Cause: Package not installed Solution: Run pip install sports-skills
Error: Team not found by ID Cause: Wrong or outdated ESPN team ID used Solution: Call get_teams to get the current list of all 30 MLB teams with their IDs
Error: No data returned for a future game Cause: ESPN only returns data for completed or in-progress games Solution: Use get_schedule to see upcoming game details; get_scoreboard only covers active/recent games
Error: Offseason — scoreboard returns 0 events Cause: No games scheduled during the offseason (November–March) Solution: Use get_standings or get_news instead; MLB offseason transactions are available via get_transactions
| Case | Status | Duration (ms) | Turns | Tokens | Tool calls | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Without | With | Δ | Without | With | Δ | Without | With | Δ | Without | With | Δ | ||
case-01 | fail→fail | 10,454 | 4,314 | -59% | 1 | 1 | 0% | 1,830 | 2,233 | +22% | 0 | 0 | — |
case-02 | fail→fail | 3,814 | 4,364 | +14% | 1 | 1 | 0% | 567 | 2,225 | +292% | 0 | 0 | — |
case-03 | pass→pass | 2,560 | 2,770 | +8% | 1 | 1 | 0% | 438 | 2,495 | +470% | 0 | 0 | — |
case-04 | pass→pass | 4,059 | 2,551 | -37% | 1 | 1 | 0% | 612 | 2,408 | +293% | 0 | 0 | — |
case-05 | fail→pass | 5,444 | 1,844 | -66% | 1 | 1 | 0% | 882 | 2,278 | +158% | 0 | 0 | — |
case-06 | fail→pass | 6,891 | 1,495 | -78% | 1 | 1 | 0% | 1,030 | 2,231 | +117% | 0 | 0 | — |
case-07 | fail→pass | 5,907 | 1,470 | -75% | 1 | 1 | 0% | 915 | 2,185 | +139% | 0 | 0 | — |
case-08 | fail→pass | 5,538 | 2,385 | -57% | 1 | 1 | 0% | 911 | 2,357 | +159% | 0 | 0 | — |
case-09 | pass→pass | 4,472 | 1,632 | -64% | 1 | 1 | 0% | 780 | 2,306 | +196% | 0 | 0 | — |
case-10 | pass→pass | 7,574 | 2,711 | -64% | 1 | 1 | 0% | 1,358 | 2,445 | +80% | 0 | 0 | — |
case-11 | fail→pass | 6,485 | 2,639 | -59% | 1 | 1 | 0% | 1,123 | 2,409 | +115% | 0 | 0 | — |
case-12 | fail→pass | 10,229 | 3,160 | -69% | 1 | 1 | 0% | 1,438 | 2,611 | +82% | 0 | 0 | — |
case-13 | pass→pass | 15,150 | 2,673 | -82% | 1 | 1 | 0% | 2,622 | 2,501 | -5% | 0 | 0 | — |
case-14 | fail→pass | 8,127 | 3,651 | -55% | 1 | 1 | 0% | 1,350 | 2,613 | +94% | 0 | 0 | — |
case-15 | pass→pass | 10,911 | 1,600 | -85% | 1 | 1 | 0% | 1,899 | 2,201 | +16% | 0 | 0 | — |
case-16 | fail→pass | 8,234 | 2,699 | -67% | 1 | 1 | 0% | 1,196 | 2,394 | +100% | 0 | 0 | — |
case-17 | fail→pass | 5,018 | 2,869 | -43% | 1 | 1 | 0% | 870 | 2,483 | +185% | 0 | 0 | — |
case-18 | fail→fail | 8,939 | 4,372 | -51% | 1 | 1 | 0% | 1,540 | 2,199 | +43% | 0 | 0 | — |
case-19 | fail→pass | 8,768 | 2,828 | -68% | 1 | 1 | 0% | 1,433 | 2,433 | +70% | 0 | 0 | — |
case-20 | fail→pass | 6,677 | 1,988 | -70% | 1 | 1 | 0% | 1,117 | 2,291 | +105% | 0 | 0 | — |
case-21 | pass→pass | 11,656 | 2,412 | -79% | 1 | 1 | 0% | 1,843 | 2,347 | +27% | 0 | 0 | — |
case-22 | fail→fail | 10,211 | 4,846 | -53% | 1 | 1 | 0% | 1,698 | 2,218 | +31% | 0 | 0 | — |
case-23 | fail→fail | 16,646 | 5,144 | -69% | 1 | 1 | 0% | 3,119 | 2,206 | -29% | 0 | 0 | — |
case-24 | fail→fail | 6,316 | 4,656 | -26% | 1 | 1 | 0% | 1,196 | 2,258 | +89% | 0 | 0 | — |
DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 24 cases were attempted, and 18 counted toward the lift figure. The other 6 produced results that are not comparable between the two arms, so they are excluded from the headline rather than averaged into it. The headline lift of +46 percentage points is the difference between those two pass rates over the 18 comparable cases.
Without the skill loaded, the model failed this case. With it loaded, the same prompt on the same model passed. This is one improved case from the latest verified run; every case, including any that regressed, is in the table above.
| Model | Method | Date | Lift |
|---|---|---|---|
| gemini-3.6-flash | verified | 8/3/2026 | +13% |
Other measured skills in the registry, with their headline benchmark lift.