CLAUDE.md git:20260921.dcae9a3A

Immutable. This exact content is served forever at /api/v1/blob/e26ac2406c45cd50.

# 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