garmin-frisbee-analysis

# Garmin Frisbee Analysis

Analyze Garmin health and performance data specifically for Ultimate Frisbee players. Generate interactive HTML dashboards for post-game review, tournament fatigue tracking, training load optimization, and season-long trend comparison.

## Two Installation Paths

1. **Clawdbot Skill** (this guide) — Use with Clawdbot for natural language queries and proactive monitoring
2. **MCP Server** ([see MCP setup guide](references/mcp_setup.md)) — Use with Claude Desktop as an MCP server

---

## Setup (first time only)

### 1. Install Dependencies

```bash
pip3 install garminconnect fitparse gpxpy
```

### 2. Configure Credentials

#### Option A: Clawdbot Config (Recommended)

```json
{
  "skills": {
    "entries": {
      "garmin-frisbee-analysis": {
        "enabled": true,
        "env": {
          "GARMIN_EMAIL": "your-email@example.com",
          "GARMIN_PASSWORD": "your-password"
        }
      }
    }
  }
}
```

#### Option B: Local Config File

```bash
cp config.example.json config.json
# Edit config.json with your email and password
```

#### Option C: Command Line

```bash
python3 scripts/garmin_auth.py login --email YOUR_EMAIL --password YOUR_PASSWORD
```

### 3. Authenticate

```bash
python3 scripts/garmin_auth.py login
python3 scripts/garmin_auth.py status   # verify
```

---

## Frisbee Scripts

### Post-Game / Post-Training Analysis

Analyze a single activity in depth: sprints, speed, heart rate zones.

```bash
# Most recent activity
python3 scripts/frisbee_activity.py --latest

# Specific date
python3 scripts/frisbee_activity.py --date 2026-03-08

# Specific activity ID
python3 scripts/frisbee_activity.py --activity-id 12345678

# Save to file
python3 scripts/frisbee_activity.py --latest --output ~/Desktop/game.html
```

**Dashboard includes:**
- Summary cards: duration, distance, sprint count, top speed, sprint fatigue index, high-intensity distance
- Speed timeline with sprint highlight bands
- Sprint peak speed trend (detects...

# Garmin Frisbee Analysis - Clawdbot Skill

> **Ultimate Frisbee performance analytics powered by Garmin data** — "how many sprints did I hit in yesterday's game?", "was my recovery fast enough between points?", "am I more fatigued than last tournament?"

Analyze sprint count & fatigue, top speed, heart rate zones, Body Battery, HRV trends, sleep quality, and generate interactive dashboards. Compare tournaments vs. training, and track season-long fitness trends. Built for competitive Ultimate Frisbee players.

## 🔵 Looking for Claude Desktop?

**This is the Clawdbot skill repo.** For standard Claude Desktop, use the dedicated MCP server:

👉 **[MCP Setup Guide](references/mcp_setup.md)** - Claude Desktop setup instructions

---

## 🚀 Clawdbot Installation

**Best for**: Post-game analysis, tournament fatigue tracking, proactive health check-ins

```bash
# Install via clawdhub
clawdhub install garmin-frisbee-analysis

# Or manually
cd ~/.clawdbot/skills
git clone https://github.com/EvelynDevelops/garmin-frisbee-analysis.git garmin-frisbee-analysis

# Install dependencies
pip3 install garminconnect fitparse gpxpy

# Configure credentials and authenticate
python3 scripts/garmin_auth.py login
```

**[📖 Full Setup Guide](SKILL.md)**

## ⚡ Features

- **Sprint analysis**: Count, top speed, fatigue index (last 3 vs first 3 sprint peaks)
- **Post-game dashboards**: Speed timeline, sprint bands, HR zone distribution
- **Tournament review**: Body Battery fatigue curve, HRR curves, overnight sleep/HRV
- **Season comparisons**: Training vs game intensity, top speed trends, volume over time
- **General health**: Sleep stages, Body Battery, HRV, resting HR, stress levels
- **Activity files**: Download FIT/GPX for detailed route and performance analysis

## 📊 Example Queries

> "How many sprints did I hit in yesterday's game?"
>
> "Was my sprint speed dropping by the end?"
>
> "Show me my tournament fatigue curve"
>
> "How did I sleep during the tournament?"
>
> "Am I improvi...