Personal Health Coach Planning Skill

0 0 Updated: 2026-07-21 20:04:20

This is the planning skill within the Personal Health Coach project, focusing on providing unified, agent-native health planning functionality for users, covering nutrition, strength training, and running. Developed based on the GitHub repository mohamed-chn/personal-health-coach, this skill aims to help users create personalized health plans and achieve health goals through intelligent planning solutions. Core features include generating customized diet and exercise plans, adapting to different user needs and preferences, and providing dynamic adjustment suggestions. Use cases include daily health management, fitness training planning, and nutritional guidance.

Install
bunx skills add https://github.com/mohamed-chn/personal-health-coach.git --skill planning
Skill Details readonly

Your AI Health Coach: From Planning to Execution in One Unified System

Ever wished you had a personal trainer who's available 24/7, knows your dietary needs, designs strength workouts, and even coaches your runs—all while adapting to your body's real-time feedback? That might sound like sci-fi, but it's actually happening right now. I recently stumbled upon an open-source project called Personal Health Coach Planning Skill, which integrates nutrition, strength training, and running into a single intelligent agent. Honestly, it's more reliable than most fitness apps because it doesn't just throw generic templates at you. Instead, it generates plans based on your personal metrics. All you need to do is input your goals, body stats, and available equipment, and it outputs a complete weekly plan. Sounds almost too good to be true, right?

The core idea behind this project is surprisingly straightforward: make AI think like a real coach. It doesn't just tell you "do squats today." Instead, it analyzes your training history, recovery capacity, and nutritional gaps before making recommendations. For instance, if you ran 5 kilometers yesterday, it might suggest reducing today's running volume while increasing protein intake. This dynamic adjustment capability is exactly what traditional fitness plans lack. After all, whose body follows a static plan book perfectly?

Three Core Modules: Nutrition, Strength, and Running Working in Harmony

What truly sets this skill apart is how it integrates three seemingly independent domains—nutrition, strength training, and running—into a cohesive system. You might ask: why not just use three separate apps? The answer is simple: they all affect each other. For example, after a heavy strength session, your body needs more carbohydrates for recovery, and your running pace should likely decrease. This intelligent agent automatically calculates these cross-effects, instead of leaving you to guess.

Here's a breakdown of its features across the three dimensions:

  • Nutrition Planning: Calculates your TDEE and macronutrient targets, then generates daily meal suggestions that even account for food allergies and preferences.
  • Strength Training: Applies the principle of progressive overload, automatically adjusting weight, sets, and reps to avoid plateaus.
  • Running Guidance: Designs combinations of interval runs, tempo runs, and recovery runs based on heart rate zones and pace targets.

These modules aren't isolated. On a strength training day, it automatically lowers running intensity and suggests increased protein intake. This holistic thinking is exactly what most fitness apps miss. Think about it: if you're only using a running app, how would it know you did leg day yesterday?

Configuring Your Personal Health Coach: A Step-by-Step Practical Guide

So, how do you actually use it? Don't worry—you don't need to be a programmer. You just need to prepare a JSON configuration file describing your basic info and goals. Below is a sample configuration you can copy and modify:

{
  "profile": {
    "age": 30,
    "weight": 75, // in kilograms
    "height": 178,
    "gender": "male",
    "activity_level": "moderate" // options: sedentary, light, moderate, active, very_active
  },
  "goals": {
    "primary": "fat_loss", // options: fat_loss, muscle_gain, maintenance
    "weekly_running_km": 25,
    "strength_sessions_per_week": 3
  },
  "preferences": {
    "diet": "balanced", // options: balanced, low_carb, high_protein
    "available_equipment": ["dumbbells", "barbell", "pull_up_bar"]
  }
}

This configuration tells the AI your body stats, goals, and available gear. Once submitted, it generates a weekly plan with daily dietary advice, training sessions, and running schedules. For example, it might tell you Tuesday is "upper body push workout + 40-minute tempo run," and suggest eating chicken breast with brown rice for lunch. Isn't that more reliable than scrolling through random Instagram posts?

Dynamic Adjustments and Progress Tracking: Why AI Understands You Better Than a Human Coach

Many people worry that AI plans will be too rigid, but ironically, this skill emphasizes dynamic adjustment above all else. It automatically optimizes subsequent plans based on your feedback data. For instance, if you report feeling fatigued for three consecutive days, it will lower training intensity. If you're progressing faster than expected on a particular exercise, it will increase difficulty ahead of schedule. This adaptive ability is actually more granular than most human coaches—after all, no real coach can analyze your heart rate data every single minute.

Additionally, it includes a built-in progress tracking module. You can log sets, weights, running pace, and perceived exertion for each session. The system compiles this data into a clear table, showing changes at a glance:

Week Squat Weight 5K Pace Body Fat Change
Week 1 60kg 5:30/km 22%
Week 4 70kg 5:10/km 20.5%
Week 8 80kg 4:50/km 19%

Seeing this table, you might think: "I can add 20kg to my squat in just 8 weeks?" Yes—that's the power of scientific planning. And the AI constantly reminds you not to quit when you hit a plateau. It will tell you, "Plateaus are normal. Consider adjusting training frequency or adding recovery time."

Why You Should Try This Open-Source Solution: Unique Value Beyond Commercial Fitness Apps

Finally, let me share what I love most about this project: it's completely open-source. This means you can inspect every algorithm logic, and even modify the code for special needs. Compare that to commercial fitness apps, which are black boxes—you never know why they recommend a particular exercise. Plus, all your data stays local with this skill, so privacy concerns vanish. Think about it: your weight, heart rate, diet logs—these are the most intimate data points. Why hand them over to a corporation?

Of course, it's not perfect. Its support for injury rehabilitation is still limited, so if you have old injuries, consult a professional first. But overall, for anyone looking to train systematically without paying a fortune for a personal trainer, this project offers a zero-cost, customizable, and deeply insightful solution. I strongly recommend downloading it, spending 30 minutes on configuration, and sticking with it for a month. Trust me—when you see your progress data, you'll thank yourself for starting today. After all, the best investment in your health is the one you make right now.