name: arccos-golf license: MIT description: Analyze Arccos Golf performance data including club distances, strokes gained metrics, scoring patterns, and round-by-round performance. Use when the user asks about golf statistics, club recommendations, performance trends, or wants detailed analysis from their Arccos Golf sensors.

Arccos Golf Performance Analyzer

Fetches live data from the Arccos Golf API and generates performance analysis: strokes gained, club distances, scoring, putting, pace of play, and recent rounds.

⚠️ Privacy & Security Notice

This skill makes authenticated network requests to Arccos Golf API servers using your account credentials:

• Credentials: Your Arccos email and password are used to authenticate. A session token is cached at ~/.arccos_creds.json (mode 0600, readable only by your user).
• Network: The script calls authentication.arccosgolf.com (login) and api.arccosgolf.com (data). No other endpoints are contacted.
• No data leaves your machine beyond the API calls needed to fetch your own golf data.
• External dependency: Requires the arccos library from github.com/pfrederiksen/arccos-api (MIT licensed, authored by the same user who published this skill).

Review the arccos library source before installing if you have concerns: https://github.com/pfrederiksen/arccos-api

Prerequisites

# 1. Install the arccos library
git clone https://github.com/pfrederiksen/arccos-api
pip install -e arccos-api/

# 2. Authenticate — opens a prompt for email + password
#    Credentials cached to ~/.arccos_creds.json (0600)
arccos login

Alternatively, pass credentials directly at runtime (see Usage below).

Usage

Full report (uses cached credentials)

python3 scripts/arccos_golf.py

Pass credentials explicitly (no cached creds required)

python3 scripts/arccos_golf.py --email you@example.com --password secret

Specific sections

python3 scripts/arccos_golf.py --summary
python3 scripts/arccos_golf.py --strokes-gained
python3 scripts/arccos_golf.py --clubs           # all clubs
python3 scripts/arccos_golf.py --clubs iron       # filter by type
python3 scripts/arccos_golf.py --pace
python3 scripts/arccos_golf.py --recent-rounds 10

JSON output

python3 scripts/arccos_golf.py --format json

Offline / no credentials (cached JSON file)

python3 scripts/arccos_golf.py --file /path/to/arccos-data.json

System Access

API Calls Made

All calls are authenticated with a Bearer JWT. The JWT is obtained from and refreshed against authentication.arccosgolf.com using your arccos session credentials.

Dependencies

• Python ≥ 3.11
• arccos library: github.com/pfrederiksen/arccos-api (MIT) — wraps requests, click, rich
• Standard library only in the analysis script itself