fitness-coach-rpg

Logs workouts in local Markdown and JSON files with RPG progression and optional story mode.

86|18|Updated May 4, 2026
One-click install
npx skills add https://github.com/chenklein26-maker/fitness-coach-rpg --skill fitness-coach-rpg-chenklein26-maker
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fitness-coach-rpg
Source: https://github.com/chenklein26-maker/fitness-coach-rpg
Command: npx skills add https://github.com/chenklein26-maker/fitness-coach-rpg --skill fitness-coach-rpg-chenklein26-maker

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? It turns scattered workout notes into a persistent, local-file training system where an AI coach tracks weights, reps, RPE, recovery, and long-term progression across sessions, with an optional RPG layer that converts training results into levels, attributes, and narrative advancement. ## Core Features & Use Cases - Workout logging and state tracking: Appends daily sessions to user-data/sessions/YYYY-MM-DD.json and recomputes EXP, level, attributes, recovery, and personal bests in CURRENT-STATE.json via zero-dependency Python scripts. - Recovery-aware planning: Adjusts recommended intensity based on days since last session plus six correction factors such as sleep, pain, and recent RPE trends, including comeback protocols after long breaks. - Optional RPG story mode: Maps push/pull/legs training to narrative scenes using a reusable story engine, narrative templates, and a ready-made default world, all customizable per user. - Use Case: After a two-week break you tell the AI "开始训练"; it reads your recent sessions, detects the interruption, reduces your bench press load by 20-30%, guides the session, records the results, updates your level, and advances your story chapter. ## Quick Start Tell the AI "开始训练" or "初始化档案" and answer the four setup questions about your goal, equipment, injury history, and whether you want to train today.

Frequently Asked Questions about fitness-coach-rpg

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

FAQPage Schema
How do I start tracking workouts with an AI fitness coach?▼

Clone the repository and tell the AI "开始训练" or "初始化档案". The initialization only asks four questions: your goal, equipment and experience level, injury history, and whether you want to train today. The AI then creates your profile files and guides your first session.

How does the AI adjust training after a long break?▼

It computes days since your last session and applies a baseline reduction: 10-15% lighter for 7-14 days off, 20-30% for 15-30 days, and full baseline rebuilding after 30 days. Six correction factors like poor sleep, lingering soreness, or active pain can reduce intensity further.

Do I need Python installed to use this workout logging system?▼

No. The Python scripts only make updates more reliable. Without Python, the AI can directly write the session JSON files and update CURRENT-STATE.json by hand, following the format in the example session file.

Can I use the fitness coach without the RPG story mode?▼

Yes. Story mode is optional and can be turned off at any time. With it disabled, the system works as a pure coaching tool that logs training data, manages recovery, and adjusts plans without any narrative output.

What training styles does the coach support besides strength training?▼

The default methodology is a push-pull-legs strength program, but the coach guide reference covers six alternative styles including fat loss, HIIT, yoga, posture correction, and gentle beginner training. You can also mix styles, such as strength days with one method and cardio days with another.

Where is my workout data stored and is it private?▼

All data lives in local Markdown and JSON files inside a user-data directory that is excluded from git by default. Nothing is sent to external services; the entire system runs on local file read and write within your own workspace.