Pp Espn

<!-- GENERATED FILE — DO NOT EDIT. This file is a verbatim mirror of library/media-and-entertainment/espn/SKILL.md, regenerated post-merge by tools/generate-skills/. Hand-edits here are silently overwritten on the next regen. Edit the library/ source instead. See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

ESPN — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the espn-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows: ``bash npx -y @mvanhorn/printing-press-library install espn --cli-only ``
2. Verify: espn-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer):

go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/espn/cmd/espn-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

When to Use This CLI

Reach for this when a user wants a quick sports lookup - current score, standings, upcoming schedule, head-to-head record, or a rich per-game summary (box score, leaders, scoring plays, odds, win probability). Also good for cross-league discovery (today) and offline search across synced data.

Don't reach for this if the user has a paid feed like Stats Perform or Sportradar that provides cleaner data, or if they need real-time websocket updates (ESPN's endpoints are polling-only). For betting odds in isolation, the per-game summary payload includes them but there is no league-wide odds command.

Unique Capabilities

Commands that only work because of local sync + cross-league tooling.

Cross-league discovery

• `today` — Today's scores across all major sports in one call. The fastest "what's on tonight" answer without picking a sport first.

• `trending` — Most-followed athletes and teams across all leagues, ranked by current popularity. Good for "who is hot right now" without naming a sport.

• `dashboard` — Reads [favorites] from ~/.config/espn-pp-cli/config.toml and shows scores for each favorited team across leagues, in one call.

• `watch <sport> <league> --event <game_id>` — Live score updates for a specific game (polls every 30s). Use scores or today to find the game, then watch to follow it live.

Game-state intelligence

• `summary <sport> <league> --event <game_id>` — Detailed game summary including box score, leaders, scoring plays, odds, and win probability. The single richest payload per game.

• `boxscore <event_id>` — Just the per-player box score for an event id, with sport+league inferred from a recent scoreboard cache hit. Pass --sport/--league to skip inference.

• `plays <sport> <league> --event <id>` — Play-by-play feed for a specific event. Optional --limit (default 200).

• `recap <sport> <league>` — Post-game recap with box score and leaders for the most recent completed game in a league.

• `scoreboard <sport> <league>` — Live scoreboard with date filtering, week/group selectors, and competition metadata.

• `odds <sport> <league>` — Spread, over/under, and moneyline lines for tonight's slate, derived from the scoreboard payload (no per-game summary calls).

Standings and rankings

• `standings <sport> <league>` — Conference/division standings.

• `rankings <sport> <league>` — Current AP, Coaches, and CFP poll rankings (NCAAF/NCAAM).

• `streak <sport> <league>` — Current win/loss streaks across teams in a league, computed from synced data.

• `rivals <sport> <league>` — Head-to-head records between teams in a league from synced data.

• `h2h <team1> <team2> --sport <s> --league <l>` — Deeper head-to-head detail for one specific pair, including average score and recent meetings list.

• `sos <sport> <league>` — Strength-of-schedule per team, derived from the standings payload, sorted descending.

People

• `leaders <sport> <league> [--category <name>]` — Statistical leaders across categories with optional filter.

• `compare <athlete1> <athlete2> --sport <s> --league <l>` — Side-by-side season stats for two athletes. Ambiguous names list candidates and exit 2.

• `injuries <sport> <league>` — Active injury report across the league, grouped by team.

• `transactions <sport> <league>` — Recent trades, signings, and waivers.

Local store

• `sync` — Pull a sport+league dataset into local SQLite for offline analysis.

• `search "<query>"` — Full-text search across synced events and news.

• `sql <query>` — Run read-only SQL queries against the local database.

Command Reference

Live action:

• espn-pp-cli scores <sport> <league> — Current scores
• espn-pp-cli today — Today's scores across all major sports
• espn-pp-cli scoreboard <sport> <league> — Scoreboard with optional date filtering
• espn-pp-cli watch <sport> <league> --event <game_id> — Live score polling for one game
• espn-pp-cli standings <sport> <league> — League standings
• espn-pp-cli trending — Most-followed athletes and teams across leagues
• espn-pp-cli dashboard — Favorites snapshot from ~/.config/espn-pp-cli/config.toml

Team detail:

• espn-pp-cli teams <sport> <league> <team_id> — Schedule for one team (past + upcoming)
• espn-pp-cli teams get <sport> <league> <team_id> — Team record, links, and logos
• espn-pp-cli teams list <sport> <league> — All teams in a league
• espn-pp-cli streak <sport> <league> — Current win/loss streaks from synced data
• espn-pp-cli rivals <sport> <league> — Head-to-head records between teams from synced data
• espn-pp-cli h2h <team1> <team2> --sport <s> --league <l> — Deeper detail for one team pair (avg score, meetings)
• espn-pp-cli sos <sport> <league> — Strength-of-schedule, sorted descending

Game detail:

• espn-pp-cli summary <sport> <league> --event <game_id> — Full game summary (box score, leaders, scoring plays, odds, win probability)
• espn-pp-cli boxscore <event_id> — Just the box score subtree (sport/league inferred from cache)
• espn-pp-cli plays <sport> <league> --event <id> — Play-by-play feed (optional --limit, default 200)
• espn-pp-cli recap <sport> <league> — Most recent completed game recap
• espn-pp-cli odds <sport> <league> — Spread, over/under, moneyline for tonight's slate

People:

• espn-pp-cli leaders <sport> <league> [--category <name>] — Statistical leaders by category
• espn-pp-cli compare <athlete1> <athlete2> --sport <s> --league <l> — Side-by-side athlete stats
• espn-pp-cli injuries <sport> <league> — Active injury report
• espn-pp-cli transactions <sport> <league> — Recent trades, signings, waivers

Polls and rankings:

• espn-pp-cli rankings <sport> <league> — AP, Coaches, and CFP polls

Info:

• espn-pp-cli news <sport> <league> — Latest news

Discovery and local:

• espn-pp-cli search "<query>" — Full-text search across synced events and news
• espn-pp-cli sync — Sync a sport+league into local SQLite
• espn-pp-cli sql "<query>" — Run read-only SQL against the local store
• espn-pp-cli load — Show workload distribution per assignee (synced data)
• espn-pp-cli orphans / stale — Maintenance views over the local store
• espn-pp-cli doctor — Verify connectivity and configuration

Sport values: football, basketball, baseball, hockey, soccer. League values: nfl, nba, mlb, nhl, ncaaf, ncaam, ncaaw, mls, eng.1 (EPL), wnba.

Recipes