workout_skill

Overview

This skill provides a command-line interface to track workouts, log sets, manage exercises and templates, and maintain multi-user profiles. It helps users record gym sessions, view history, and analyze strength progression using accurate numeric logging and per-profile data. It supports templates, equipment-specific exercises, PRs, volume reports, and JSON output for integrations.

How this skill works

The CLI manages a shared exercise library and per-profile data including templates, workouts, and config. Users start sessions from templates or empty sessions, log sets with weight and reps, add notes for context, edit or undo sets, and finish sessions. It enforces adding unknown exercises before logging and requires real numeric weights and reps for accurate analytics.

When to use it

• Recording a live gym session with accurate weight and rep data
• Reviewing exercise history, PRs, or weekly volume for a profile
• Creating or using workout templates for consistent training days
• Managing workouts for multiple people via profiles
• Swapping or editing sets during a session when mistakes occur

Best practices

• Always add a new exercise to the library before attempting to log it
• Log true numeric weights and reps—notes must not substitute for numbers
• Use notes only for context (injuries, form cues, equipment issues)
• Use equipment-specific exercise names to keep progression clean
• Use undo/edit/delete commands during the session to correct mistakes

Example use cases

• Start a profile session: workout --profile mike start push then log bench-press sets
• Create a new exercise before recording a movement: workout exercises add "Dumbbell RDL" --muscles hamstrings,glutes --type compound --equipment dumbbell
• Track progress: workout progression bench-press or workout pr bench-press to view gains
• Fix a wrong entry: workout edit bench-press 2 155 8 or workout undo to remove the last set
• Run reports or integrate with tools using --json output for volume or history