Pp Sprocket

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/productivity/sprocket/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/". -->

Sprocket Sports — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the sprocket-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:

   npx -y @mvanhorn/printing-press-library install sprocket --cli-only

2. Verify: sprocket-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.4 or newer). This installs into $GOPATH/bin (default $HOME/go/bin), so add that directory to $PATH instead:

go install github.com/mvanhorn/printing-press-library/library/productivity/sprocket/cmd/sprocket-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.

Sprocket Sports CLI wraps your club's Sprocket dashboard API so you can answer the questions a parent actually asks: 'when is the next game' (next), 'what's on this week' (week), 'plan the next two weeks for both kids' (agenda), 'any double-bookings' (conflicts), and 'what do we owe' (owed). It merges every one of your players' teams into a single view the per-team web dashboard can't produce, and exports everything to your phone calendar with ical.

When to Use This CLI

Use this CLI when an agent or script needs a Sprocket Sports club's schedule, rosters, programs, registrations, or dues — especially merged across multiple children and teams, or as date-math (next game, this week, conflicts, away games) that the per-team web dashboard cannot answer in one view. It is ideal for reminders, carpool and away-game planning, iCal subscriptions, and 'what do we owe' roll-ups.

Anti-triggers

Do not use this CLI for:

• Do not use this CLI for league scores or standings — the parent dashboard API does not expose them (they are league-admin level).
• Do not use it for coach or club announcements and messaging — that surface is not available here.
• Do not use it to register, pay, RSVP, or otherwise change anything — v1 is strictly read-only.
• Works for any Sprocket club, but only one at a time: it targets whatever SPROCKET_CLUB / SPROCKET_BASE_URL (or config base_url) is set to, defaulting to jfcsoccer. The token must match that club. Don't expect cross-club queries in a single invocation.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Schedule, the way a parent asks

• week — Every game and practice for the current week across all your players' teams, in one view.

  Reach for this when asked 'what's on this week' for a family with kids on different teams.

  sprocket week

• next — The single next upcoming game or practice across all your players' teams: what, when, where, home/away, opponent.

  Reach for this for 'when is my kid's next game' or a one-line reminder.

  sprocket next --agent --select clubCalendarEvent.title,clubCalendarEvent.startDate,clubCalendarEvent.opponent,clubCalendarEvent.awayGame

• agenda — Both kids' separate team schedules merged into one chronological agenda over an N-day window.

  Reach for this to plan the family's next two weeks in a single sorted list.

  sprocket agenda --days 14

• conflicts — Flags time overlaps and impossible tight time-plus-location gaps between events across all your players.

  Reach for this to catch a double-booked Saturday before Saturday morning.

  sprocket conflicts --days 14

• away — Away games only, location-first, with field, opponent, and date — built for the carpool group chat.

  Reach for this when planning away-game driving or posting a travel list.

  sprocket away --weeks 4

• ical — Emit the merged schedule as an RFC-5545 .ics file for phone-calendar subscription.

  Reach for this to get soccer events into Apple/Google Calendar.

  sprocket ical --days 60

• since — What schedule items were added, moved, or cancelled since the last time you ran it.

  Reach for this to catch a moved practice or a newly-added game.

  sprocket since

Money and deadlines

• owed — Total money owed across all your players: registration balances plus overdue invoices, with one number.

  Reach for this for 'what do we still owe the club' across multiple kids.

  sprocket owed

• deadlines — Open registration programs sorted by how soon they close, flagging ones closing within N days.

  Reach for this to avoid missing a registration window.

  sprocket deadlines --days 14

Command Reference

account — Your account and roles

• sprocket-pp-cli account clubs — List clubs this account belongs to
• sprocket-pp-cli account me — Get your club-user account profile
• sprocket-pp-cli account roles — List your account roles

club — Club information

• sprocket-pp-cli club get — Get club metadata
• sprocket-pp-cli club settings — Get public club settings

family — Your family group

• sprocket-pp-cli family — Get your family (parents/guardians and players)

payments — Dues and outstanding payments

• sprocket-pp-cli payments failed — List failed payments
• sprocket-pp-cli payments overdue-invoices — List overdue invoice payments (dues owed)
• sprocket-pp-cli payments overdue-tickets — List overdue ticket payments

players — Your players

• sprocket-pp-cli players — List your players (children) on this account

programs — Club programs and registration

• sprocket-pp-cli programs list — List all club programs/seasons
• sprocket-pp-cli programs open — List programs currently open for registration

registrations — Registration and payment history

• sprocket-pp-cli registrations completed — List completed program registrations (with balances)
• sprocket-pp-cli registrations team — List completed team registrations

schedule — Club calendar — games, practices, and events

• sprocket-pp-cli schedule event-types — List calendar event types (game, practice, etc.)
• sprocket-pp-cli schedule list — List calendar events in a date window (max ~31 days). Dates are YYYY-MM-DD.
• sprocket-pp-cli schedule settings — Calendar display settings for the club

teams — Club teams

• sprocket-pp-cli teams list — List every team in the club
• sprocket-pp-cli teams mine — List the teams your players are assigned to

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

sprocket-pp-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.

Recipes

Next game as a one-line reminder

sprocket next --agent --select clubCalendarEvent.title,clubCalendarEvent.startDate,clubCalendarEvent.opponent,clubCalendarEvent.awayGame

Narrow the deeply-nested event to just the fields a reminder needs; pipe to a text/cron job.

Two-week family agenda

sprocket agenda --days 14

Merge both kids' team schedules into one sorted list for the next two weeks.