skill

workout-tracker

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

marswangyang/workout-trackercommunitylistedunreviewed

Set up

Skills are installed by placing their folder where your agent loads skills.

Download ZIP from GitHub Open the repository

The download comes from github.com/marswangyang/workout-tracker itself, not from our server, so what you get is exactly what its author published.

Install instructions come from the README

Skills do not use an MCP config. Follow the steps in the README below.

README

synced Oct 23, 2026

Workout Tracker Skill for Clawdbot

A powerful, AI-native fitness tracking skill designed for Clawdbot. It leverages SQLite for data storage, Python scripts for logic, and LLM capabilities for natural language interaction.

🚀 Features

Natural Language Logging: Just say "I did 5 sets of Bench Press at 100lb", and it's logged.
Smart Rest Timer: Automatically infers your rest time based on your past habits for specific exercises.
Mobile-Optimized Reports: Generates beautiful, portrait-mode images of your workout history, perfect for viewing on phones (Discord/WhatsApp).
Muscle Group Tracking: Automatically categorizes exercises into body parts (Chest, Legs, Back, etc.).
Visual Recognition: Can analyze photos of gym equipment to suggest exercises.
Privacy First: All data is stored locally in a sqlite database.

🛠️ Architecture

Database: SQLite (workout.db) managed via SQLModel (ORM).
Package Management: Uses uv for fast, modern Python dependency management.
Visualization: Uses matplotlib and pandas to render pixel-perfect report images.

📦 Installation

This skill is designed to be dropped into your Clawdbot skills/ directory.

Dependencies: Ensure you have uv installed.
```
brew install uv
```
Sync Environment: Navigate to the scripts directory and install dependencies:
```
cd scripts
uv sync
```

📖 Usage

Logging a Workout

User: "I did Bench Press, 135lbs, 5 sets of 5." Agent: (Parses input and runs log.py)

Viewing History

User: "Show me my Bench Press progress." Agent: (Runs render.py and sends a generated image chart)

🔧 File Structure

workout-tracker/
├── README.md           # This file
├── SKILL.md            # Instruction manual for the AI Agent
├── _meta.json          # Skill metadata for registry
└── scripts/            # Python backend
    ├── log.py          # Logging logic
    ├── render.py       # Image generation logic
    ├── report.py       # Text report logic
    ├── models.py       # Database schema
    └── pyproject.toml  # Dependency config

👤 Author

marswangyang