Pp Espn
Query live scores, standings, schedules, box scores, and head-to-head stats across major leagues from the terminal or agent without an ESPN API key.
Overview
pp-espn is an agent skill for the Build phase that runs the ESPN Printing Press CLI to fetch live scores, standings, schedules, and detailed game summaries without an API key.
Install
npx skills add https://github.com/mvanhorn/printing-press-library --skill pp-espnWhat is this skill?
- Live scores and standings across 10 leagues (NFL, NBA, MLB, NHL, NCAA, MLS, EPL, WNBA)
- Per-game summaries: box score, leaders, scoring plays, odds, win probability
- Offline search, head-to-head comparisons, team schedules, polls, and rankings
- No ESPN API key; drives Printing Press espn-pp-cli via Bash
- Natural-language triggers for scores, schedules, and standings questions
- 10 leagues covered in the ESPN CLI scope
Adoption & trust: 2.3k installs on skills.sh; 1.5k GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You need trustworthy live sports scores and standings in an agent workflow but do not want to sign up for or maintain a separate ESPN API integration.
Who is it for?
Indie builders wiring sports-aware CLIs, OpenClaw-style agents, or quick terminal checks during app development.
Skip if: Production betting, compliance-heavy data licensing, or teams that require official ESPN partner APIs and SLAs instead of a community CLI.
When should I use this skill?
User asks about live sports scores, standings, team stats, game summaries, schedules, polls, rankings, or head-to-head matchups in natural language.
What do I get? / Deliverables
Your agent installs espn-pp-cli and returns league scores, schedules, box scores, and comparisons from documented subcommands instead of guessing from the web.
- Terminal JSON or text sports query results
- Installed espn-pp-cli binary
Recommended Skills
Journey fit
Sports data access is a build-time integration when you wire agents, CLIs, or side projects that need authoritative game and standings payloads. Installs and invokes the espn-pp-cli Go binary as an external data source—classic third-party integration work, not shipping or growth copy.
How it compares
A packaged sports CLI skill, not a general web-search substitute or an MCP-only connector.
Common Questions / FAQ
Who is pp-espn for?
Solo and indie developers who want ESPN-shaped sports data from the terminal or agent during build and integration work, without API keys.
When should I use pp-espn?
Use it in Build when you need live scores, standings, schedules, or box scores for agent demos, sports side projects, or integration prototypes; also when validating UX copy against real game state.
Is pp-espn safe to install?
Review the Security Audits panel on this Prism page and inspect the Go module source; the skill expects Bash and a locally built espn-pp-cli binary.
SKILL.md
READMESKILL.md - 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.3 or newer): ```bash 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, odd