commit 377c231a3b4e282a61c06be5c0f77e1d181e915f
Author: Helios Agent <agent.helios82@gmail.com>
Date:   Mon Feb 23 01:24:36 2026 +0100

    Initial commit for helios-hevy

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..495b2cc
--- /dev/null
+++ b/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
diff --git a/SKILL.md b/SKILL.md
new file mode 100644
index 0000000..d0e1746
--- /dev/null
+++ b/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