Hockey Skills -- Claude Code Instructions

Public Repo Rules

This is a public, open-source repository. Every commit, file, and message is visible to anyone.

Never include:

• AI attribution or co-author lines in commits, code, or comments
• Personal information (names, emails, addresses, usernames beyond the org)
• API keys, secrets, tokens, or credentials (even expired ones)
• Internal URLs, private repo paths, or filesystem paths (e.g., /Users/*)
• References to private repos, internal tools, or business strategy
• Revenue numbers, pricing strategy discussions, or customer data
• References to other projects (PuckCast, OWSH, brain vault, etc.)

Commit messages:

• Written as if by the project maintainer, not an AI
• Describe the what and why, no "Generated by" or "Co-Authored-By" lines
• Keep them concise and professional

Code and content:

• No "AI-powered", "intelligent", or similar buzzwords
• No comments referencing internal conversations or decisions
• Skill descriptions should be factual and specific to what the skill does
• Credit costs must match the live PuckAPI pricing (see puckapi-tool/endpoints.md)

Repo Structure

claude-sports-analytics/
├── .claude-plugin/plugin.json   # Plugin manifest
├── skills/                      # 28 skill directories
│   ├── puckapi-tool/            # MCP tool reference (endpoints + fields)
│   ├── hockey-analytics/        # Core metrics and concepts
│   ├── game-lookup/             # Finding and filtering games
│   └── ...                      # See README for full list
└── docs/                        # Glossaries, routing, season logic

Key Facts

• 28 skills, all NHL/hockey focused
• MCP server at mcp.puckapi.com/mcp
• Data starts from the 2010-11 season. 16 completed seasons plus the one in progress. Do not claim 2008-09; it is not there
• 32 active NHL teams (includes Utah Hockey Club, not Arizona Coyotes)
• Odds from the books PuckAPI tracks (DraftKings, FanDuel, BetMGM, ESPN BET and others). The count moves as books come and go, so do not publish a number.
• 15 MCP tools with credit costs defined in puckapi-tool/endpoints.md
• Shot-quality metrics are returned by the API, not computed by the caller: gsax, expectedGoalsAgainst, highDangerSavePct, rollingSavePct, rollingGsax, trend, restDays on goalies; corsiPct, fenwickPct, expectedGoalsFor, expectedGoalsAgainst on teams; goalie_starts with time on ice on get_game_detail
• Team possession is 5v5 by convention, goalie expected goals cover every strength. Never difference the two