New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Nhl Data

by machina-sports in machina-sports/sports-skills

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…

MITAuto-check passedData & Analytics

Install Nhl Data

skills CLI
$ npx skills add machina-sports/sports-skills --skill nhl-data -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install machina-sports/sports-skills nhl-data --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/machina-sports/sports-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/nhl-data .claude/skills/nhl-data && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
nhl-data
GitHub stars
245
Token cost
~2.4k tokens
SKILL.md length
1,054 words
Files
4 (incl. scripts, references)
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

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…

  • Works in 3 steps: Derive season year from currentDate → Call get_standings(season=) → Filter results for Eastern Conference
  • : user asks about NHL scores
  • SKILL.md covers Setup, Quick Start, CRITICAL: Before Any Query and Choosing the Season, plus 6 more sections
  • Runs Shell scripts from its folder; calls pip and python3

What it does

Nhl Data is an agent skill from machina-sports/sports-skills. 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…

Its SKILL.md is about 2.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts and reference files (for example `references/api-reference.md`, `references/team-ids.md` and `scripts/validate_params.sh`).

It sits in Data & Analytics, covering Statistics. It works with Kalshi, Polymarket and Python. The repository describes itself as: Open-source agent skills for live sports data and prediction markets. Football, F1, Kalshi, Polymarket. Zero API keys. SKILL.md format. The licence is MIT.

When your agent uses it

  • : user asks about NHL scores
  • Betting futures
  • Team/player statistics
  • Skater/goalie leaders

Example prompts

  • “/nhl-data”

Requirements

  • Python 3
  • A Bash shell

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Derive season year from currentDate
  2. Call get_standings(season=)
  3. Filter results for Eastern Conference

What it can do on your machine

Read from SKILL.md and the folder at commit 0420a7c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • pip
    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Nhl Data loads about 2.4k tokens when it runs, and up to ~4.1k if it reads all its reference files. Until then it costs about 248 tokens; SKILL.md has 1,054 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~248
When it runs · the whole SKILL.md, loaded when a task matches
~2.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from machina-sports/sports-skills at commit 0420a7c, republished under its MIT licence (© machina-sports). 1,054 words, ~2,353 tokens.

Download SKILL.mdSave it as .claude/skills/nhl-data/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
nhl-data
description
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.
license
MIT
metadata.author
machina-sports
metadata.version
0.1.0

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:

bash
which 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:

bash
python3 --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.

Quick Start

Prefer the CLI — it avoids Python import path issues:

bash
sports-skills nhl get_scoreboard
sports-skills nhl get_standings --season=2025
sports-skills nhl get_teams

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 get_teams 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

CommandDescription
get_scoreboardLive/recent NHL scores
get_standingsStandings by conference and division
get_teamsAll NHL teams
get_team_rosterFull roster for a team
get_team_scheduleSchedule for a specific team
get_game_summaryDetailed box score and scoring plays
get_leadersNHL statistical leaders
get_newsNHL news articles
get_play_by_playFull play-by-play for a game
get_scheduleGames on a specific date (no season filter; see get_team_schedule)
get_injuriesInjury reports across all teams
get_transactionsRecent transactions
get_futuresFutures/odds markets
get_team_statsTeam statistical profile
get_player_statsPlayer statistical profile
find_nhl_playerSearch the NHL's player registry by name
get_nhlstats_scheduleGames via the NHL API — team seasons to the Original Six era, NHL game ids
get_nhlstats_player_statsCareer season-by-season across leagues via NHL API
get_nhlstats_player_game_logOne player's games in a season (opponent, home/away, result, stat line) via NHL API
get_nhlstats_play_by_playPlay-by-play with on-ice x/y coordinates, zone, shot type
get_nhlstats_boxscoreFull box score (skaters + goalies) via NHL API
get_nhlstats_standingsStandings, current or any historical date (back to 1917)
get_nhlstats_leadersSkater and goalie leaders by category

See references/api-reference.md for full parameter lists and return shapes.

Using ESPN and the NHL API Together

The get_nhlstats_* commands read api-web.nhle.com — the NHL's current API. (The retired statsapi.web.nhl.com, which most community docs still describe, no longer resolves.) It carries the analytics layer ESPN does not: on-ice shot coordinates, cross-league career rows, goalie leaders, and history to the Original Six era. The two sources use unrelated id systems:

  • Game ids. NHL ids are 10 digits encoding season/type/game (2023030417); ESPN uses 9-digit event ids (401559593). No shared column — join on the game date plus teams.
  • Team abbreviations. Five teams differ: ESPN LA/NJ/SJ/TB/UTAH vs NHL LAK/NJD/SJS/TBL/UTA. Every get_nhlstats_* team filter accepts either spelling, and rows carry both (team_abbreviation, team_abbreviation_espn).
  • Player ids. NHL player ids (8478402) and ESPN athlete ids are unrelated. Resolve names with find_nhl_player; ASCII spellings match accented names ("stutzle" finds "Tim Stützle").
  • Career rows span leagues. get_nhlstats_player_stats returns every league a player appeared in, each row labelled with league and is_nhl — filter to is_nhl before summing career numbers. A player traded mid-season has one NHL row per team plus a team: "TOTAL" row (is_total: true, counting stats summed, rate stats omitted); skip is_total rows when summing.
  • Seasons. Pass the starting year (season=2024 means 2024-25). The NHL form ("20242025") is also accepted.
  • How a final was decided. status is the NHL's game state (OFF/FINAL for any final). decided_by on schedule rows and box scores is REG, OT or SO (null until final). Shootout scores follow the official result: the winner is credited one goal (a 1-1 game won in the shootout is 2-1).
  • Blocked shots. In get_nhlstats_play_by_play, team_id and player on a blocked-shot row are the shooter's (the NHL's event owner); the box score's blockedShots credits the defender, given as blocking_player and blocking_team_id. Count blocks by blocking_team_id.
Show full SKILL.md (412 more words)Show less

Examples

Example 1: Today's scores User says: "What are today's NHL scores?" Actions:

  1. Call get_scoreboard() Result: All live and recent NHL games with scores and status

Example 2: Conference standings User says: "Show me the Eastern Conference standings" Actions:

  1. Derive season year from currentDate
  2. Call get_standings(season=<derived_year>)
  3. Filter results for Eastern Conference Result: Eastern Conference standings with W-L-OTL, points, regulation wins

Example 3: Team roster User says: "Who's on the Maple Leafs roster?" Actions:

  1. Call get_team_roster(team_id="21") Result: Full Maple Leafs roster with name, position, jersey number, shoots/catches

Example 4: Game box score User says: "Show me the full box score for last night's Bruins game" Actions:

  1. Call get_scoreboard(date="<yesterday>") to find the event_id
  2. Call get_game_summary(event_id=<id>) for full box score Result: Complete box score with per-player stats and scoring plays

Example 5: Stanley Cup odds User says: "What are the Stanley Cup odds?" Actions:

  1. Call get_futures(limit=10) Result: Top Stanley Cup contenders with odds values

Example 6: Player statistics User says: "Show me Connor McDavid's stats" Actions:

  1. Derive season year from currentDate
  2. Call get_player_stats(player_id="3895074", season_year=<derived_year>) Result: Season stats by category with value, rank, and per-game averages

Commands that DO NOT exist — never call these

  • 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.

Error Handling

When a command fails, do not surface raw errors to the user. Instead:

  1. Catch silently and try alternatives
  2. If team name given instead of ID, use get_teams to find the ID first
  3. Only report failure with a clean message after exhausting alternatives

Troubleshooting

Error: 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 NHL teams with their IDs (expansion teams like the Seattle Kraken and Utah Mammoth have non-sequential 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 (July–September) Solution: Use get_standings or get_news instead; use get_schedule to find when the season resumes

© machina-sports, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts, references) in skills/nhl-data of machina-sports/sports-skills.

  • SKILL.md
  • references/api-reference.md
  • references/team-ids.md
  • scripts/validate_params.sh

Open the folder on GitHubat commit 0420a7c

Compare with similar skills

Nhl Data next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Nhl Data compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Nhl Data this skillmachina-sports/sports-skills245—~2.4kAutomated safety check: PassMIT
StatsmodelszLanqing/codex-claude-academic-skills4.7k15 repos~4.9kAutomated safety check: PassBSD-3-Clause
Rota Bench Regression Analysisoracle/graalpython1.7k—~1.6kAutomated safety check: PassCustom licence
MatlabzLanqing/codex-claude-academic-skills4.7k8 repos~2.3kAutomated safety check: NotesGPL-3.0
Polymarket Tennislivetennisapi/livetennisapi-mcp152—~3kAutomated safety check: PassMIT
Meridian MMM Model Buildinggoogle/meridian1.6k—~2.5kAutomated safety check: PassApache-2.0

Similar skills

  • Statsmodels

    zLanqing/codex-claude-academic-skills

    Statistical models library for Python. An agent skill from zLanqing/codex-claude-academic-skills.

    4.7k GitHub starsUsed in 15 repos~4.9k tokens
    Data & AnalyticsAuto-check passed

  • Rota Bench Regression Analysis

    oracle/graalpython

    Official

    Analyze recent GraalPy benchmark regressions on master as part of the weekly rota.

    1.7k GitHub stars~1.6k tokensUpdated 2 days ago
    Data & AnalyticsAuto-check passed

  • Matlab

    zLanqing/codex-claude-academic-skills

    MATLAB and GNU Octave numerical computing for matrix operations, data analysis, visualization, and scientific computing.

    4.7k GitHub starsUsed in 8 repos~2.3k tokens
    Data & AnalyticsAuto-check: notes

  • Polymarket Tennis

    livetennisapi/livetennisapi-mcp

    Build observe-only Polymarket and Kalshi tennis market tooling on the polymarket-tennis Python package (MIT) plus the Live Tennis API free tier.

    152 GitHub stars~3k tokensUpdated 4 days ago
    Business, Finance & HRAuto-check passed

  • Meridian MMM Model Building

    google/meridian

    Official

    Takes a user through building a Meridian marketing mix model, from loading CSV data and mapping columns to running EDA, fitting and saving the model.

    1.6k GitHub stars~2.5k tokensUpdated yesterday
    Data & AnalyticsAuto-check passed

  • Statistical Data Analysis

    lingzhi227/agent-research-skills

    Writes statistical analysis code for experimental data, runs it through a four-round review, and reports effect sizes, p-values and confidence intervals.

    390 GitHub stars~886 tokensUpdated 7 mo ago
    Data & AnalyticsAuto-check passed

More from machina-sports/sports-skills

All 23 skills in this repo

  • Cbb Data

    machina-sports/sports-skills

    College Basketball (CBB) data via ESPN public endpoints and the NCAA's official endpoints — scores, standings, rosters, schedules, game summaries, play-by-play, win probability, rankings, futures…

    245 GitHub stars~2.2k tokensUpdated today
    Auto-check passed

  • Cfb Data

    machina-sports/sports-skills

    College Football (CFB) data via ESPN public endpoints and the NCAA's official endpoints — scores, standings, rosters, schedules, game summaries, play-by-play, rankings, injuries, futures…

    245 GitHub stars~2.9k tokensUpdated today
    Auto-check passed

  • Cricket Data

    machina-sports/sports-skills

    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…

    245 GitHub stars~1.7k tokensUpdated today
    Auto-check passed

  • Fastf1

    machina-sports/sports-skills

    Formula 1 data — race schedules, results, lap timing, driver and team info.

    245 GitHub stars~1.6k tokensUpdated today
    Auto-check passed

  • Golf Data

    machina-sports/sports-skills

    PGA Tour, LPGA, and DP World Tour golf data via ESPN public endpoints — tournament leaderboards, scorecards, season schedules, golfer profiles/overviews, and news.

    245 GitHub stars~1.7k tokensUpdated today
    Auto-check passed

  • Kalshi

    machina-sports/sports-skills

    Kalshi prediction markets — events, series, markets, trades, and candlestick data.

    245 GitHub stars~1.9k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Nhl Data

What does Nhl Data do?

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…. Nhl Data is an agent skill from machina-sports/sports-skills. 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.

When should I use Nhl Data?

Nhl Data fits situations like: : user asks about NHL scores; betting futures; team/player statistics; skater/goalie leaders.

How do I install Nhl Data in Claude Code?

Run `npx skills add machina-sports/sports-skills --skill nhl-data -a claude-code`. Or copy the skill folder (skills/nhl-data in machina-sports/sports-skills) into .claude/skills/nhl-data in your project. Claude Code loads it when a task matches its description.

How do I install Nhl Data in Codex?

Run `npx skills add machina-sports/sports-skills --skill nhl-data -a codex`. Or copy the skill folder (skills/nhl-data in machina-sports/sports-skills) into .agents/skills/nhl-data in your project. Codex loads it when a task matches its description.

Can I use Nhl Data in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add machina-sports/sports-skills --skill nhl-data -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nhl-data, .gemini/skills/nhl-data, .github/skills/nhl-data and .opencode/skills/nhl-data in your project.

What does Nhl Data need to run?

Going by SKILL.md and its folder, Nhl Data needs a shell for the scripts in its folder and the command-line tools its instructions call (pip and python3). Our summary lists: Python 3; A Bash shell.

Does Nhl Data access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Nhl Data safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Nhl Data use?

Nhl Data is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Nhl Data use?

About 2.4k tokens (SKILL.md is roughly 9.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.8k tokens, read only when the agent opens those files.

What are the alternatives to Nhl Data?

Skills that share tags, products or a category with Nhl Data: Statsmodels (zLanqing/codex-claude-academic-skills, 4.7k stars), Rota Bench Regression Analysis (oracle/graalpython, 1.7k stars), Matlab (zLanqing/codex-claude-academic-skills, 4.7k stars) and Polymarket Tennis (livetennisapi/livetennisapi-mcp, 152 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Nhl Data?

machina-sports (a GitHub organization) maintains it in machina-sports/sports-skills, which has 245 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on October 10, 2026.

Source: machina-sports/sports-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.