model-building SKILL.md skillA

model-building from puckapi/claude-sports-analytics is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add puckapi/claude-sports-analytics/model-building@v1.0.0

Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
puckapi/claude-sports-analytics
Path
skills/model-building/SKILL.md
Versions recorded
4
Latest version
v1.0.0, committed May 6, 2026
First version recorded
May 1, 2026
Size
13,293 bytes
Repository stars
3
License
MIT

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…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file 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

The exact contents, by fingerprint
mdr add puckapi/claude-sports-analytics/model-building@sha256:7338cb75c515b67b

The line at the top of this page pins the label v1.0.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

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

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, between May 1, 2026 and May 6, 2026, about one every 2 days.

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. Fixed automatic checks with no AI involved, so the same checks give the 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-10-15 · 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 AI assistant 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.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from puckapi/claude-sports-analytics

CLAUDE.md CLAUDE.md file
puckapi/claude-sports-analytics · CLAUDE.md
git:20260921.dcae9a3 · audit A · 3 stars
ai-hockey-workflow SKILL.md 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.md 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.md 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.md 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.md 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.md 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.md 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.md 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.md 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.md 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.md 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.