🇺🇸English

Workout Tracker

A skill to log and track fitness activities using a local SQLite database.

Capabilities

1. Log Workout: Record exercise details.
2. View History: See past performance.
3. Smart Rest Time: Auto-fills rest time based on previous sessions if not provided.
4. Visual Recognition: Can identify gym equipment from images to suggest exercises.

Usage

1. Logging a Workout

When the user says "I did 5 sets of Bench Press at 60kg for 8 reps", parse the details and run:

cd skills/workout-tracker/scripts && uv run log.py \
  --exercise "Bench Press" \
  --weight 60 \
  --unit kg \
  --sets 5 \
  --reps 8 \
  --body_part "Chest" \
  --rest_time 90  # Optional: User provided or leave empty to auto-fill
  --notes "Optional notes"

Parameters:

• --exercise (Required): Name of the movement.
• --body_part: (New) Target muscle group (e.g. Chest, Back, Legs). INFER THIS from the exercise if not provided (e.g. Bench -> Chest).
• --weight (Required): Weight value.
• --unit: 'kg' or 'lb' (default kg).
• --sets: Number of sets.
• --reps: Reps per set.
• --rest_time: Seconds. OMIT THIS if the user didn't specify. The script will auto-fill from history.

2. Viewing History

When the user asks "How is my Squat progress?" or "Show last workouts":

cd skills/workout-tracker/scripts && uv run render.py --exercise "Squat"

Then send the generated image: message(action="send", filePath="/tmp/workout_report.png", message="Here is your report:")

3. Image Recognition (Vision)

If the user uploads an image (e.g., of a machine):

1. Analyze the image using your vision capabilities.
2. Identify the equipment (e.g., "Leg Press Machine", "Dumbbells").
3. Ask the user: "This looks like a Leg Press. Do you want to log a set? How much weight?"
4. Once they reply, use the log.py script as usual.

Design & Behavior Rules (User Preferences)

1. User Profile

• Type: General User (Casual).
• Interaction: Use natural language. Automatically infer the body_part from the exercise name (e.g., "Bench Press" -> "Chest") without asking, unless ambiguous.

2. Display Format (Mobile Portrait)

• Preferred Output: Always generate an Image for reports using render.py.
• Style: Vertical (Portrait) aspect ratio optimized for mobile screens.
• Layout:
  • Narrow width (figsize width ~6).
  • Wrap long text in "Notes" column.
  • Hide "Exercise" column if filtering by a single exercise (title context is enough).
  • Sort chronologically (Oldest -> Newest) within the day/session.

3. Logging Logic

• Drop Sets: Must be logged as separate rows for data accuracy.
  • Rest Time: Set to 0 between drop set segments.
  • Notes: Mark as "Drop set part X/Y" for clarity.
• Units: User prefers lb (pounds).

Database

Data is stored in skills/workout-tracker/workout.db (SQLite). The schema includes date, exercise, weight, unit, sets, reps, rest_time, notes.

Technical Setup (Maintenance)

This skill uses uv for Python package management.

Installation

1. Ensure uv is installed: brew install uv

2. Sync dependencies:

   cd skills/workout-tracker/scripts
   uv sync
   

Database Schema (SQLModel)

The SQLite database (workout.db) uses the following schema:

• id: Integer (PK)
• date: ISO8601 String
• exercise: String
• body_part: String (Target muscle group)
• weight: Float
• unit: String (default "kg")
• sets: Integer
• reps: Integer
• rest_time: Integer (Seconds, optional)
• notes: String (Optional)

Weekly Installs

50

Repository

marswangyang/wo…-tracker

First Seen

Jan 30, 2026

Security Audits

Gen Agent Trust HubPassSocketPassSnykPass

Installed on

gemini-cli47

codex47

opencode47

github-copilot46

cursor46

cline45