convert-workout-journal

Convert raw gym notes into Dataview-compatible fitness logs in Obsidian.

3|1|Updated Jun 20, 2016
One-click install
npx skills add https://github.com/paulchiu/dotfiles --skill convert-workout-journal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convert-workout-journal
Source: https://github.com/paulchiu/dotfiles/tree/main/.config/opencode/skills/convert-workout-journal
Command: npx skills add https://github.com/paulchiu/dotfiles --skill convert-workout-journal

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Converts raw gym journal notes into structured, Dataview-compatible fitness logs in the Obsidian vault, reducing manual entry and enabling robust querying across workouts.

Core Features & Use Cases

  • Parses raw journal notes to extract exercises, sets, reps, weights, durations, and notes into a deterministic JSON structure.
  • Generates Obsidian-ready files: a workout file, per-exercise notes, and an aggregated dashboard, all rooted under Area/Fitness.
  • References a canonical registry (scripts/exercises.json) and uses Python scripts (parse_journal.py and generate_workout.py) to ensure repeatable, idempotent imports.

Quick Start

Parse a raw journal for a specific date using parse_journal.py and feed the resulting JSON to generate_workout.py to create the workout and exercise notes.

Frequently Asked Questions about convert-workout-journal

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert raw gym notes into structured workout logs in Obsidian?

To convert raw gym notes into structured workout logs in Obsidian, this Skill uses Python scripts to parse journal entries and generate Dataview-compatible fitness files. It extracts exercises, sets, reps, and weights into a deterministic JSON structure to populate your vault automatically.

Can I automate importing fitness data into an Obsidian Dataview dashboard?

Yes, you can automate importing fitness data into an Obsidian Dataview dashboard by running the parse and generate Python scripts. This creates an aggregated dashboard alongside individual workout and exercise notes rooted under the Area/Fitness directory.

What is the best way to structure exercise notes for Dataview queries in a vault?

The best way to structure exercise notes for Dataview queries is using a canonical exercises.json registry. This ensures repeatable and idempotent imports by standardizing extracted exercise data into a deterministic JSON format before generating Obsidian-ready files.

Do I need Python to parse workout journals and generate Obsidian files?

Yes, you need Python to parse workout journals and generate Obsidian files because the workflow relies on two specific scripts, parse_journal.py and generate_workout.py. These scripts process raw journal text and output the structured markdown files for your vault.

How does parsing raw journal notes work for fitness tracking in Obsidian?

Parsing raw journal notes for fitness tracking works by extracting sets, reps, weights, durations, and notes from unstructured text. The parsed data is fed into a generation script that creates per-exercise notes and an aggregated dashboard under the Area/Fitness folder.

Are there limitations when converting unstructured gym notes into a Dataview-compatible format?

A limitation when converting unstructured gym notes into a Dataview-compatible format is the dependency on a canonical exercises.json registry for accurate matching. If raw journal entries deviate significantly from expected naming conventions, parsing accuracy may decrease.