# 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 2008-09 season (16+ seasons)
- 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.
- 12 MCP tools with credit costs defined in puckapi-tool/endpoints.md