io.github.bjornj12/golf-coach

Check or (re)establish your Trackman sign-in. Actions: - `status` (default): report whether the current token works and who you're signed in as. Use this first; it never opens anything. - `login`: (re)authenticate. If already signed in, confirms instantly. If the saved session expired and `open_browser` is true, it opens a sign-in window and returns immediately with `pending: true` — the window stays open for a few minutes and the user signs in at their own pace (the browser is driven by a background task, so it won't close on its own). After the user says they've finished, call `auth(action='status')` to confirm. Do NOT re-call `login` while one is pending — it won't open a second window. `source` selects the data source to authenticate; only `trackman` needs auth (other sources, e.g. GameBook, are local). Never echoes the token.

Render a coaching diagnosis into a self-contained animated HTML page. Returns `{html}` — one standalone document (inline canvas/JS, no network, no external resources) ready to drop straight into a Claude **HTML artifact**. `data` shape (all optional; the viz adapts): {title, subtitle, diagnosis, handedness "RH"|"LH", shots:[{launchDirection,launchAngle,carry,total, totalSide,curve,maxHeight,landingAngle,hangTime}], swing:{clubPath,faceAngle,faceToPath}, targets:[{label,value,target,low, high,met}], blocks:[{name,detail,goal,where "range"|"home", links:[{label,url}]}]}. Renders the measured flight (side view + top-down, animated) and drills grouped range/home. See the trackman-visualizer prompt.

On-course rounds ingested from Golf GameBook screenshots (local, last 5). The `gamebook-screenshot-analysis` skill extracts a round from screenshots and saves it here. Only score-per-hole is trusted; every other dimension carries a `coverage` flag (`full`|`partial`|`none`) and analysis respects it. Actions: - `save` (needs `round`): a coverage-aware record — {date, course:{par,cr,slope}, result:{gross,net,to_par,position}, holes:[{hole,par,score,putts?,fairway?, gir?,bunkers?,chips?,penalties?}], coverage:{...}, dimensions:{...}}. Runs a self-check (hole sums vs gross/par); refuses inconsistent reads. Computes the `scoring` block, stores it (last 5), returns the stored record. - `list`: index of stored rounds (id, date, gross, net, to_par, coverage), newest first. - `get` (needs `round_id`): one full stored round. - `compare` (optional `round_id`, default latest): deterministic deltas vs the rounds before it — scoring always, other dimensions only where both tracked them. Returns measurement; the coach narrates progress from it.

Per-session analysis (deterministic classification + metrics, stored locally). Actions: - `analyze` (needs `activity_id`): fetch a session, classify it (warm-up vs serious practice vs game), compute metrics, normalize vs prior stored sessions, store the record (last 30 kept), and return it. - `get` (needs `activity_id`): return one stored analysis record. - `list`: return the index of stored analyses (most recent first). Drive this with the `trackman-session-analyzer` prompt.

One-call onboarding for the Trackman golf coach. Returns everything needed to set the coach up in your client: - `system_prompt`: paste into a Claude/ChatGPT **Project's** custom instructions so every chat in it is the coach (with this MCP connected); - `skills`: upload-ready `SKILL.md` files (Settings → Capabilities → Skills) for always-on auto-activation; - `instructions`: per-client steps (Claude Projects, Desktop Skills, ChatGPT, Claude Code). An MCP server can't create the Project or enable Skills itself — this hands you the content + steps. In Claude Code, the assistant can write the files for you directly from this kit. (Pairs with the `setup` prompt.)

Cross-source, context-aware view: runs each source's expert analyzer and aligns their findings by skill area (no verdicts — the coach interprets). Also returns two extra FACTUAL sections (measurement-only): `delivery` — the driver club-delivery facts (path / face-to-path / spin-axis / attack / spin); and `leak_ranking` — skill areas ordered by measured deviation-from-band severity. If the Trackman token has expired (and a silent refresh failed), this raises loudly rather than returning an empty view — re-auth with `auth(action='login')` and retry.

Trackman data reads (controlled/flat-lie launch-monitor data). Raw only. Actions: - `profile`: identity + current handicap (`hcp.currentHcp`, latest record). - `handicap` (paging `skip`/`take` default 20, `only_in_avg`): handicap history — per-round differentials and how the index moved. - `sessions` (`skip`/`take` default 25, `kinds`, `time_from`/`time_to`, `include_hidden`): list activities (practice sessions and course rounds) — totalCount + a page of item summaries. Use `session` with an item's id for full detail. - `session` (needs `activity_id`): one activity in full, with shot-level launch metrics (RANGE_PRACTICE strokes) or the scorecard (COURSE_PLAY). - `rounds` (`skip`/`take` default 20, `completed`): course rounds (scorecards) — per-hole scores and round `stat` aggregates. `completed=None` returns all rounds regardless of completion state. - `clubs` (`include_retired`): per-club gapping and dispersion ("My Bag" / Find My Distance) — the source for gapping analysis. - `summary` (`time_from`/`time_to`, `skip`/`take` default 50): activity counts grouped by kind over an optional time window. `take` defaults to each action's own historical default (20 for `handicap` and `rounds`, 25 for `sessions`, 50 for `summary`) when omitted; pass it explicitly to override.

The coach's memory: save prescribed practice plans and recall/grade them. Actions: - `save` (needs `plan`): persist a prescribed plan to the pending queue. The `plan` is a structured dict — title, focus, diagnosis, blocks [{name, club, reps, detail, link, goal}], and optional `target_specs` (machine-readable targets, e.g. {metric:'clubPath', club:'DRIVER', op:'between', low:-1, high:2}) used by `verify`. Returns the stored plan (with id). Capped at the most recent 50. - `next`: return the next pending plan — the answer to "what's today's training?". - `list` (optional `status`='pending'|'done'): list plans, oldest→newest. - `done` (needs `plan_id`, optional `result_session_id`): mark a plan complete. - `verify` (needs `plan_id`, optional `activity_id`): grade a recent session's real shot metrics against the plan's `target_specs`; returns per-target session-mean vs target, `all_met`, and a recommendation.