Home / puckapi / claude-sports-analytics · skills/xg-model-building/SKILL.md · GitHub

xg-model-building skillA

xg-model-building is agent-read markdown (skill) from puckapi/claude-sports-analytics: Builds expected goals (xG) models from NHL play-by-play shot event data using XGBoost or LightGBM. Use when user asks about expected goals, xG model, shot quality, building an xG model, xGF%, xGA, rebound detection, rush shot detection, or shot probability. Do not use for applying pre-built xG values to team or game analysis -- see team-analysis or hockey-analytics. Do not use for general game prediction models -- see model-building. Do not use for goalie evaluation using xGA -- see goalie-analy.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# xG Model Building

> **Important: PuckAPI does NOT have play-by-play data.** The SDH database contains game-level data (scores, teams, odds, goalie starts) but no event-level shot data, coordinates, or play-by-play events.
>
> **Primary data source for xG:** The NHL Stats API at `api-web.nhle.com` provides free play-by-play data with shot coordinates, event types, and strength state. No API key or credits required.
>
> **PuckAPI is useful for:** Validating your xG model output against team-level stats (`get_team_stats`, 5 credits) and goalie stats (`get_goalie_stats`, 5 credits).
>
> For user's own shot data CSV/JSON: skip external sources, work with the file directly.

You are an expert in hockey expected goals modeling. Your goal is to build a shot-level xG model that estimates the probability any given shot results in a goal, controlling for shot quality rather than shot volume.

## When to Use

- User asks "how do I build an xG model"
- User wants to model shot probability or goal probability from play-by-play data
- User wants to compute xGF%, xGA, or expected goals for teams or players
- User asks about rebound detection, rush shot detection, or shot angle features
…

Read the whole file at its exact version.

How to install

Latest version
mdr add puckapi/claude-sports-analytics/xg-model-building@v1.1.0
Exact content
mdr add puckapi/claude-sports-analytics/xg-model-building@sha256:51496bee4f328421

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_eurwz2fgilesokf5.svg)](https://markdownregistry.com/a/art_eurwz2fgilesokf5)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
v1.1.0 latest2026-05-06 3355ba8 12,439 BA view · diff
v1.1.02026-05-04 c1ac62a 12,481 BA view · diff
v1.0.02026-05-01 df6b9a7 11,494 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (12439 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

puckapi/claude-sports-analytics · 3 stars · license MIT · pushed 2026-09-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_eurwz2fgilesokf5
GET https://markdownregistry.com/api/v1/resolve?ref=puckapi/claude-sports-analytics/xg-model-building
GET https://markdownregistry.com/api/v1/blob/51496bee4f328421ccc0fea0d3797d8c91130d5b4623e8ea7ac3f32be77a4691

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from puckapi/claude-sports-analytics

CLAUDE.md claude
puckapi/claude-sports-analytics · CLAUDE.md
git:20260921.dcae9a3 · audit A · 3 stars
ai-hockey-workflow skill
puckapi/claude-sports-analytics · skills/ai-hockey-workflow/SKILL.md · Teaches how to use Claude and MCP tools effectively for hockey analytics -- exploratory analysis, hypothesis testing…
v1.0.0 · audit A · 3 stars
backtesting skill
puckapi/claude-sports-analytics · skills/backtesting/SKILL.md · Walk-forward historical testing of betting strategies to determine whether a model's edge is real. Use when user asks…
v1.0.0 · audit A · 3 stars
bet-tracker skill
puckapi/claude-sports-analytics · skills/bet-tracker/SKILL.md · Track predictions vs actuals in production: log bets, compute CLV, monitor ROI, detect edge decay, and run significance…
v1.0.0 · audit A · 3 stars
daily-card skill
puckapi/claude-sports-analytics · skills/daily-card/SKILL.md · Full slate analysis for tonight's games with edge rankings, odds across books, and recommended stakes. Use when user…
v1.0.0 · audit A · 3 stars
data-pipeline skill
puckapi/claude-sports-analytics · skills/data-pipeline/SKILL.md · Builds automated sports analytics pipelines -- daily data pulls, scheduled prediction generation, model versioning…
v1.0.0 · audit A · 3 stars
dispatch skill
puckapi/claude-sports-analytics · skills/dispatch/SKILL.md · Routes hockey analytics requests to the right 2-3 skills. Load this FIRST when a hockey data or analytics request comes…
v1.0.0 · audit A · 3 stars
edge-detection skill
puckapi/claude-sports-analytics · skills/edge-detection/SKILL.md · Compares model probabilities against market odds to find positive expected value bets. Use when user asks about EV…
v1.0.0 · audit A · 3 stars
elo-engineering skill
puckapi/claude-sports-analytics · skills/elo-engineering/SKILL.md · Builds multi-variant Elo rating systems for sports prediction. Use when user asks about Elo ratings, rating systems…
v1.0.0 · audit A · 3 stars
feature-engineering skill
puckapi/claude-sports-analytics · skills/feature-engineering/SKILL.md · Transforms raw game, player, and goalie data into model-ready features with built-in leakage detection. Use when user…
v1.0.0 · audit A · 3 stars
game-lookup skill
puckapi/claude-sports-analytics · skills/game-lookup/SKILL.md · Finds games by date, team, matchup, or season -- past results, tonight's slate, upcoming schedule, head-to-head…
v1.0.0 · audit A · 3 stars
game-preview skill
puckapi/claude-sports-analytics · skills/game-preview/SKILL.md · Complete pre-game analysis for a single NHL (or other sport) matchup: team records, goalie matchup, key stats, odds…
v1.0.0 · audit A · 3 stars

Every file in puckapi/claude-sports-analytics

Browse by kind, by grade A, or by owner.