log-workout

Log workouts into Obsidian and compare sets, reps, and weights against historical entries.

Updated Mar 6, 2026

Search Tags:#obsidian #fitness #journal #workout #progress #exercise #log

Ready to run

npx skills add https://github.com/SizhuangHe/claude-code-skills --skill log-workout

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: log-workout
Source: https://github.com/SizhuangHe/claude-code-skills/tree/main/skills/log-workout
Command: npx skills add https://github.com/SizhuangHe/claude-code-skills --skill log-workout

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of manually formatting and recording workout sessions and removes the manual effort of checking past entries to identify progress or regressions.

Core Features & Use Cases

Guided capture: Asks three concise questions (split, exercises, feel) to collect structured workout details.
History comparison: Reads recent entries from the Workouts folder and compares sets, reps, and weights to mark improvements, declines, or PRs.
Formatted output: Generates a ready-to-save Markdown note with frontmatter, exercise table, mapped muscle tags, and summary notes for Obsidian.
Use case: Quickly log a gym session, see which lifts improved since the last time that split was done, and save a clean, date-stamped note to your fitness vault.

Quick Start

Run the log-workout skill or say log-workout and answer the three prompts to create a formatted Obsidian workout note and compare it to prior entries.

Frequently Asked Questions about log-workout

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

FAQPage Schema

How do I log workouts in Obsidian and track my lifting progress?▼

To log workouts in Obsidian, this Skill asks for your split, exercises, and subjective feel, then generates a formatted Markdown note. It reads prior fitness entries to compare sets, reps, and weights, automatically marking improvements or PRs.

Can I automatically map my workout splits to muscle groups in Markdown?▼

Yes, automatic split mapping to muscle groups is supported when generating your Markdown entry. The Skill processes your workout details and outputs validated frontmatter with mapped muscle tags ready for your Obsidian vault.

How do I compare today's gym session weights against my previous entries?▼

Comparing today's gym session weights against previous entries is handled by reading recent files from your Workouts folder. The Skill detects improvements, declines, and PRs by validating your current sets and reps against historical fitness data.

Do I need a specific folder structure to record fitness journals in Obsidian?▼

Yes, you need an existing folder structure at ~/Desktop/Notes/Fitness/Workouts/ to store your entries. The Skill reads recent Markdown files from this specific directory to compare exercises and save new workout logs.

What information do I need to provide to create a workout log entry?▼

You need to provide your workout split, the specific exercises performed, and your subjective feel of the session. These three inputs are used to generate a date-stamped Markdown entry with exercise tables and progress comparisons.

Best way to automate Obsidian fitness journal creation for daily gym sessions?▼

Automating Obsidian fitness journal creation is done by running the Skill and answering three concise prompts. It removes manual formatting effort by directly outputting a structured Markdown note with frontmatter, exercise tables, and summary notes.