Initial commit for helios-hevy

README.md

@@ -0,0 +1,15 @@
+# Helios Hevy Skill
+
+Access Moritz' training data from Hevy via API.
+
+## Usage
+
+This skill provides `curl` commands in `SKILL.md` to fetch workouts, exercises, and routines.
+Requires an API key in `~/.openclaw/secrets/hevy.env`.
+
+## Features
+
+- Fetch workout history
+- View routine details
+- Check exercise templates
+- Track workout volume/progress

SKILL.md

@@ -0,0 +1,71 @@
+---
+name: hevy
+description: Query Hevy workout data via API. View workouts, exercises, routines, and training progress.
+---
+
+# Hevy
+
+Access Moritz' training data from Hevy.
+
+## Auth
+
+API key stored in `~/.openclaw/secrets/hevy.env`. All requests need header `api-key: $HEVY_API_KEY`.
+
+## Base URL
+
+`https://api.hevyapp.com/v1`
+
+## Endpoints
+
+### Workouts (paginated)
+```bash
+source ~/.openclaw/secrets/hevy.env
+curl -s -H "api-key: $HEVY_API_KEY" "https://api.hevyapp.com/v1/workouts?page=1&pageSize=5"
+```
+Returns: `page`, `page_count`, `workouts[]` with exercises and sets.
+
+### Single Workout
+```bash
+curl -s -H "api-key: $HEVY_API_KEY" "https://api.hevyapp.com/v1/workouts/{workoutId}"
+```
+
+### Workout Count
+```bash
+curl -s -H "api-key: $HEVY_API_KEY" "https://api.hevyapp.com/v1/workouts/count"
+```
+
+### Routines
+```bash
+curl -s -H "api-key: $HEVY_API_KEY" "https://api.hevyapp.com/v1/routines?page=1&pageSize=5"
+```
+
+### Exercise Templates
+```bash
+curl -s -H "api-key: $HEVY_API_KEY" "https://api.hevyapp.com/v1/exercise_templates?page=1&pageSize=10"
+```
+
+### Workout Events (since timestamp)
+```bash
+curl -s -H "api-key: $HEVY_API_KEY" "https://api.hevyapp.com/v1/workouts/events?since=2026-01-01T00:00:00Z&page=1&pageSize=5"
+```
+
+## Data Format
+
+Each workout contains:
+- `title`: Workout name (e.g. "Oberkörper", "Unterkörper")
+- `start_time` / `end_time`: ISO timestamps
+- `exercises[]`: Array of exercises, each with:
+  - `title`: Exercise name
+  - `notes`: User notes
+  - `sets[]`: Array with `weight_kg`, `reps`, `rpe`, `distance_meters`, `duration_seconds`
+
+## Routines
+
+- *Oberkörper*: Pull Ups, Dips, Rows, Incline Bench, OHP, Lateral Raise, Bench Machine, Preacher Curl
+- *Unterkörper*: Deadlift, Squat Machine, Reverse Lunge, Leg Curl, Leg Extension, Calf Raises, Abs
+
+## Notes
+
+- Weights are always in kg
+- Pagination: `page` (1-indexed), `pageSize` (max probably 10)
+- All timestamps in ISO 8601