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

model-building skillA

model-building is agent-read markdown (skill) from puckapi/claude-sports-analytics: Trains and validates prediction models for sports game outcomes. Use when user asks about building a prediction model, training a classifier, choosing between logistic regression or XGBoost, model selection, hyperparameter tuning, feature importance, or ensemble methods. Always uses walk-forward methodology -- refuses k-fold. Do not use for feature construction -- see feature-engineering. Do not use for validating probability calibration -- see probability-calibration. Do not use for xG models s.

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

# Model Building

> **Default data tool:** PuckAPI (`puckapi-tool`).
> Use `get_games` for historical game results (5 credits per query).
> Model training consumes no credits -- credits are spent in data collection and feature engineering upstream.

You are an expert in building sports prediction models. Your goal is to train classifiers that produce honest accuracy estimates on held-out walk-forward test folds. Training accuracy is never reported. Walk-forward test accuracy is the only number that matters.

## When to Use

- User wants to build a model that predicts game outcomes
- User asks which algorithm to use (logistic regression vs random forest vs XGBoost)
- User wants to tune hyperparameters
- User wants to combine multiple models into an ensemble
- User wants to understand which features matter
- User has features ready and wants to train

## When NOT to Use

- Feature construction -- see `feature-engineering`
- Evaluating whether walk-forward methodology is correctly implemented -- see `walk-forward-validation`
- Verifying that predicted probabilities are calibrated -- see `probability-calibration`
- xG (expected goals) models specifically -- see `xg-model-building`
…

Read the whole file at its exact version.

How to install

Latest version
mdr add puckapi/claude-sports-analytics/model-building@v1.0.0
Exact content
mdr add puckapi/claude-sports-analytics/model-building@sha256:7338cb75c515b67b

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_tfq2kxuiqvjuvlc3.svg)](https://markdownregistry.com/a/art_tfq2kxuiqvjuvlc3)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
v1.0.0 latest2026-05-06 3355ba8 13,293 BA view · diff
v1.0.02026-05-04 5c5b790 13,319 BA view · diff
v1.0.02026-05-04 c1ac62a 13,319 BA view · diff
v1.0.02026-05-01 df6b9a7 13,319 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 (13293 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_tfq2kxuiqvjuvlc3
GET https://markdownregistry.com/api/v1/resolve?ref=puckapi/claude-sports-analytics/model-building
GET https://markdownregistry.com/api/v1/blob/7338cb75c515b67b180ecc274d3b4c5a94f844db598d6829d7f42414d75a01f2

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.