Agent skill · data analytics · machina-sports
nhl-data
NHL data via ESPN public endpoints and the official NHL API — scores, standings, rosters, schedules, game summaries, injuries, futures, leaders, and news, plus an analytics backend: play-by-play with on-ice coordinates, cross-league career rows, skater/goalie leaders, and history to 1917. Zero config, no API keys. Use when: user asks about NHL scores, standings, team rosters, schedules, game stats, box scores, play-by-play, injuries, transactions, betting futures, team/player statistics, NHL news, shot locations, career stats, skater/goalie leaders, or historical NHL seasons. Don't use when: user asks about other hockey leagues (AHL, KHL, college hockey). For other sports use: nfl-data (NFL), nba-data (NBA), wnba-data (WNBA), mlb-data (MLB), football-data (soccer), tennis-data (tennis), golf-data (golf), cricket-data (cricket), cfb-data (college football), cbb-data (college basketball), fastf1 (F1). For betting odds use polymarket or kalshi. For news use sports-news.
Why this skill is useful
Provides access to niche NHL data endpoints and specific commands for retrieving scores, standings, and player statistics that the AI wouldn't reliably generate on its own.
What it needs
Requires sports-skills installed locally. About 5k tokens when loaded. Last updated 2026-08-06. 201 stars on the source repository.
What this skill does
NHL Data Before writing queries, consult references/api-reference.md for endpoints, ID conventions, and data shapes. Setup Before first use, check if the CLI is available: If pip install fails with a Python version error, the package requires Python 3.10+. Find a compatible Python: No API keys required. Quick Start Prefer the CLI — it avoids Python import path issues: CRITICAL: Before Any Query CRITICAL: Before calling any data endpoint, verify: Season year is derived from the system prompt's currentDate — never hardcoded. If only a team name is provided, call getteams to resolve the team ID before using team-specific commands. Choosing the Season Derive the current year from the system prompt's date (e.g., currentDate: 2026-02-18 → 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 NHL season runs October–June. If the current month is October–December, the active season year matches the current year. If January–June, the active season started the previous calendar year (use that year as the season). Example: Current date is February 2026 → active season started October 2025 → use season 2025. Commands Command Description --- --- getscoreboard Live/recent NHL scores getstandings Standings by conference and division getteams All NHL teams getteamroster Full roster for a team getteamschedule Schedule for a specific team getgamesummary Detailed box score and scoring plays getleaders NHL statistical leaders getnews NHL news articles getplaybyplay Full play-by-play for a game getschedule Schedule for a specific date or season getinjuries Injury reports across all teams gettransactions Recent transactions getfutures Futures/odds markets getteamstats Team statistical profile getplayerstats Player statistical profile findnhlplayer Search the NHL's player registry by name getnhlstatsschedule Games via the NHL API — team seasons to the Original Six era, NHL game ids getnhlstatsplayerstats Car …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills machina-sports/nhl-data