puckapi-tool

puckapi-tool is a skill for Claude Code from PuckAPI/claude-sports-analytics. It costs 81 tokens per session (2,539 once invoked), scanned A, original, MIT.

A data-retrieval skill for NHL information, including games, schedules, standings, player statistics, goalie performance, and betting odds. Other skills call it through its listed tools.

In plain words
What is it for?
Use it indirectly for NHL lookups such as schedules, team or player statistics, standings, game details, head-to-head records, and odds.
Why use it?
It provides a defined route for fetching hockey data instead of requiring each skill to handle data access separately.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the puckapi-skills plugin — 28 skills shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/puckapi/claude-sports-analytics/puckapi-tool
Any agent
npx skills add PuckAPI/claude-sports-analytics --skill puckapi-tool
Clone the repo
git clone --depth 1 https://github.com/PuckAPI/claude-sports-analytics

Made for: Claude Code.

Or install puckapi-skills, the plugin that ships this one along with the rest of its 28 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for puckapi-tool

README.md
[![agentmods](https://agentmods.dev/badge/skills/puckapi/claude-sports-analytics/puckapi-tool.svg)](https://agentmods.dev/skills/puckapi/claude-sports-analytics/puckapi-tool)
Your own site
<a href="https://agentmods.dev/skills/puckapi/claude-sports-analytics/puckapi-tool"><img src="https://agentmods.dev/badge/skills/puckapi/claude-sports-analytics/puckapi-tool.svg" alt="Measured on agentmods" height="20"></a>
Per session 81 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,539 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00081 $0.02539
Opus 5 $0.00041 $0.01269
Sonnet 5 $0.00016 $0.00508
Haiku 4.5 $0.00008 $0.00254

Measured 5d ago against content hash 39536a63dbfc, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

puckapi-tool scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/puckapi-tool/SKILL.md · 201 lines

How it starts

The opening of the file, as written. The whole thing — 201 lines — stays where its author put it; the contents beside it link to each section on GitHub.

PuckAPI Tool

Every other skill delegates data retrieval here. This skill owns the 12 MCP tools, routes requests to the right endpoint, tracks credit cost, and handles the fallback when users bring their own data.

Database coverage: 22,037 games (16 seasons, 2008-2024) | 106,958 odds records (2020-2026 NHL seasons) | 3,021 players | 1,509 goalie-season records | 494 standings records | 34 franchises (32 active + 2 historical)

Full parameter schemas: See endpoints.md in this directory (Level 3 -- load on demand).


When to Use Each Tool

Task Tool Credits
List all teams list_teams 1
Upcoming schedule get_schedule 2
Find a player by name search_players 2
League or conference standings get_standings 2
Games by date, team, or season get_games 5
Player bio + stats by NHL player ID get_player_stats 5
Single team stats + advanced metrics get_team_stats 5
Goalie leaderboard get_goalie_stats 5
Full game detail with odds + goalies get_game_detail 10
Head-to-head history between two teams get_head_to_head 10
Odds snapshot for a game get_odds 10
Opening vs closing line movement get_line_movement 25

Tool Selection Guide

Use this table when a request could match multiple tools.

You Need Use This Not This
"What games are on tonight?" get_schedule get_games (returns past games too)
"Show me BUF's last 10 games" get_games with team=BUF, limit=10 get_schedule (future only)
"Full game info with odds" get_game_detail get_games + get_odds separately
"How have BUF and TOR fared against each other?" get_head_to_head get_games filtered manually
"Where does BUF rank in the Atlantic?" get_standings with division=Atlantic get_team_stats
"BUF's Corsi and xG numbers" get_team_stats get_standings (standings have basic metrics only)
"Find Connor McDavid's ID" search_players with query=McDavid get_player_stats (requires numeric ID)
"McDavid's bio and current stats" get_player_stats with known ID search_players
"Best save percentage goalies this season" get_goalie_stats with sort_by=save_pct get_player_stats
"What's the line on tonight's BUF game?" get_odds with that game's ID get_line_movement (movement, not snapshot)
"Did DraftKings move the line today?" get_line_movement get_odds

Read the full file on GitHub · 201 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 201 lines · 81 tokens per session scan A 39536a63dbfc

Subscribe to this mod's changes

puckapi-tool is a skill published in the GitHub repository PuckAPI/claude-sports-analytics (2 stars, last pushed 3mo ago), licensed MIT. It adds 81 tokens to every session and 2,539 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

cre-asset-management

CRE Asset Management analysis suite — 9 specialist skills for post-acquisition multifamily operations including annual budgeting, monthly variance analysis, rent collection, renewal decisions, lease-up tracking, capex execution, NOI improvement, hold/sell/refi scenario analysis, and quarterly asset review memos.

ahacker-1/cre-agent-skills · 62 tokens

cre-due-diligence

CRE Due Diligence analysis suite — 7 specialist skills for multifamily property analysis including rent roll validation, expense benchmarking, market study, physical inspection, environmental review, title review, and tenant credit assessment.

ahacker-1/cre-agent-skills · 49 tokens

cre-legal

CRE Legal review suite — 6 specialist skills for PSA review, title & survey analysis, estoppel tracking, loan document review, insurance coordination, and transfer document preparation for multifamily acquisitions.

ahacker-1/cre-agent-skills · 42 tokens

cre-retail

CRE Retail analysis suite - 8 specialist skills for U.S. retail trade-area studies, rent roll and tenant mix, lease abstraction, co-tenancy and anchor risk, CAM recovery, underwriting, financing fit, and investment committee memo writing.

ahacker-1/cre-agent-skills · 52 tokens

cre-document-ingestion

CRE Document Ingestion suite — 4 specialist skills for classifying and extracting structured data from deal documents including rent rolls, T-12 financials, and offering memoranda.

ahacker-1/cre-agent-skills · 40 tokens

cre-closing

CRE Closing management suite — 2 specialist skills for closing checklist coordination and funds flow preparation for multifamily acquisitions.

ahacker-1/cre-agent-skills · 26 tokens