Agent skill · software engineering · mvanhorn
pp-boardgamegeek
Printing Press CLI for Boardgamegeek. BoardGameGeek's official XMLAPI2 (https://boardgamegeek.
Why this skill is useful
Adds specific commands and usage patterns for interacting with BoardGameGeek's XMLAPI2 that the AI wouldn't reliably generate on its own.
What it needs
Requires boardgamegeek-pp-cli installed locally. Requires boardgamegeek account access. About 5k tokens when loaded. Last updated 2026-08-06. 1,890 stars on the source repository.
What this skill does
Boardgamegeek — Printing Press CLI Prerequisites: Install the CLI This skill drives the boardgamegeek-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: 2. Verify: boardgamegeek-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). This installs into $GOPATH/bin (default $HOME/go/bin), so add that directory to $PATH instead: 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. BoardGameGeek's official XMLAPI2 (https://boardgamegeek.com/xmlapi2), the canonical database for board games, RPGs, and video games. Every endpoint returns XML; the generated client normalizes it to JSON so --json/--select and MCP tools work like any JSON API. Authorization: as of 2025-07-02 BGG requires a registered application and an Authorization: Bearer <token> header on every request (register at https://boardgamegeek.com/applications, then create a token). Requests go to boardgamegeek.com (no leading www). Scope: read-only lookup across the BGG taste graph — search, full game/thing detail with stats and rankings, the live "hot" list, user profiles, user game collections, logged plays, families, and guilds. No write/mutating endpoints. Quirk worth knowing: collection (and occasionally thing/plays) can answer with HTTP 202 and a "your request is queued, retry shortly" body the first time a large query is requested; repeat the call until the data is returned. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills mvanhorn/boardgamegeek