Running Tracker for Openclaw

An automated fitness tracking skill that logs running data, calculates performance metrics, and provides progress insights via a localized markdown database.

fdocr
v0.1.0
May 10, 2026
0
591
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install running-tracker

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install running-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 Running Tracker?

Running Tracker is a technical utility designed to transform casual workout reports into structured, actionable fitness data. By analyzing natural language inputs like "3k in 15:33," the skill maintains a persistent record of performance metrics including pace, speed, and caloric burn. It serves as a personal data scientist for runners, residing within your AI agent environment.

Built to enhance the Openclaw Skills ecosystem, this tool prioritizes data sovereignty by storing all workout history in a local markdown file. This allows for seamless portability and easy manual auditing while providing the AI with the historical context needed to offer tailored training advice and trend analysis.

Running Tracker Use Cases

  • Logging daily runs using natural language inputs like "1mi 8:20 yesterday".
  • Generating weekly or monthly running performance summaries.
  • Calculating estimated 5k or 10k race projections based on current pace data.
  • Tracking personal bests and identifying pace trends over time.
  • Requesting specific training advice based on historical workout consistency.

How Running Tracker Works

  1. The skill captures natural language input from the user and extracts the distance, date, and duration.
  2. It parses the data into a standardized format, converting units to kilometers and dates to ISO 8601 (YYYY-MM-DD).
  3. The system reads the existing runs.md file located in the base directory to maintain chronological order.
  4. A new entry is appended to the markdown table, ensuring the file remains sorted by date ascending.
  5. Performance metrics (pace, speed, and calories) are calculated in real-time.
  6. The skill generates a progress note by comparing the new data against historical entries before returning a summary to the user.

Running Tracker Setup

To enable Running Tracker within your environment, ensure your base directory is configured and initialize the storage file.

# Navigate to your agent's base directory
cd {baseDir}

# Create the runs.md file if it doesn't exist
touch runs.md

Ensure your agent has read/write permissions for {baseDir}/runs.md to allow the Openclaw Skills integration to log data successfully.

Running Tracker Data Schema & Taxonomy

The skill organizes data within a markdown table for maximum readability and compatibility.

Column Format Description
Date YYYY-MM-DD The date the run occurred
Distance string (e.g., 5k, 1mi) The raw distance covered
Time M:SS or MM:SS Duration of the workout
Pace min/km Calculated pace per kilometer

All calculations use the standard conversion factor of 1 mile = 1.60934 km and a caloric burn estimate of 62 cal/km.

Running Tracker Advanced Features

  • Multi-unit support with automatic conversion between miles and kilometers.
  • Predictive analytics for extrapolating race times for new distances.
  • Intelligent progress notes that detect streaks and performance plateaus.
  • Automated trend analysis comparing current runs to the last N days of activity.
  • Support for natural language date parsing (e.g., "today", "yesterday", "last Friday").

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*