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.

1. Dependencies: Ensure you have uv installed.

   brew install uv
   

2. 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