An intelligent fitness logging skill that parses natural language workout data into a local MySQL database for progress tracking and smart training plans.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install workout-tracker
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install workout-tracker using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Workout Tracker AI Agent Skill?
The Workout Tracker is a high-performance automation tool for fitness enthusiasts who prefer local data ownership. By leveraging Openclaw Skills, this agent interprets natural language inputs—such as squat 60kg 4 sets of 8—and transforms them into structured relational data. It bridges the gap between manual journaling and complex fitness apps, providing a developer-friendly way to manage health data.
Built with security and privacy in mind, this skill operates on a local MySQL instance. It supports real-time logging during training sessions, post-workout batch entry, and intelligent plan generation based on your existing equipment and recent muscle group fatigue levels.
Workout Tracker AI Agent Skill Use Cases
- Real-time logging of sets and reps during a gym session using simple voice or text commands like done.
- Retroactive entry of completed workouts using batch natural language parsing.
- Generating customized training plans based on available gym equipment and historical performance.
- Querying personal progress curves and training volume for specific exercises over time.
How Workout Tracker AI Agent Skill Works
- The user provides a natural language workout command which the agent parses for exercise type, weight, sets, and repetitions.
- The agent initializes a workout session and pre-schedules the planned sets into the database with a pending status.
- As the user confirms each set with done, the agent updates the specific record and provides motivational feedback.
- Upon completion, the agent calculates total duration and prompts for a subjective recovery/effort score (1-10).
- All data is securely stored in a local MySQL database using parameterized queries to ensure data integrity.
Workout Tracker AI Agent Skill Setup
1. Install Dependencies
pip install mysql-connector-python
2. Configure Environment
Create a secure .env file to store your database credentials:
cat > .workout-tracker.env << 'EOF'
MYSQL_SOCKET="/tmp/mysql.sock"
MYSQL_USER="workout_user"
MYSQL_PASSWORD="your_secure_password"
MYSQL_DATABASE="workout_tracker"
EOF
chmod 600 .workout-tracker.env
source .workout-tracker.env
3. Initialize Database
Run the initialization script to set up the required schema:
python3 scripts/init_database.py
Workout Tracker AI Agent Skill Data Schema & Taxonomy
The skill utilizes a structured relational schema to track progress accurately:
| Table | Description |
|---|---|
| exercise_types | Master list of movements, muscle groups, and equipment required. |
| gym_equipment | Inventory of available tools (dumbbells, barbells, machines). |
| workout_sessions | High-level data including date, duration, and session notes. |
| workout_items | Granular set-by-set data including weight, reps, and RPE. |
Workout Tracker AI Agent Skill Advanced Features
- Intelligent Plan Generation: Automatically analyzes the last 7 days of training to suggest muscle groups that are ready for volume while avoiding overtraining.
- Equipment-Aware Suggestions: Filters training plans based on your
gym_equipmenttable so you never get a barbell suggestion at a dumbbell-only home gym. - Parameterized SQL Security: Implements strict protection against SQL injection for all user-generated inputs.
- Flexible Parsing: Supports multiple input formats including 4x8, 4 sets of 8, and localized Chinese character numbering.
SKILL.md
Loading
Related Openclaw Skills
HumanAI Convention
A participation skill for AI agents to validate semantic grounding and receive cryptographic participation receipts via the HumanAI Convention protocol.
Douyin Video Downloader & Analyzer
A comprehensive tool for extracting watermark-free Douyin videos, performing AI-powered transcriptions, and conducting deep content analysis via Openclaw Skills.
Lessie — People Search & Enrichment
Lessie is a comprehensive intelligence tool for discovering, qualifying, and enriching professional profiles and organizational data.
Secondary Style Perturbation
A precision refinement tool that applies subtle rhythmic and linguistic variations to reduce the stylistic signatures of AI-generated content.
find-package
An AI-powered vision skill that identifies and highlights specific delivery packages on crowded shelves using pickup codes.
ScrapingBee Fetch
An advanced web extraction tool that renders JavaScript-heavy websites and returns clean Markdown optimized for LLM processing.
Featured*
