Running Readiness Assessment Skill - Health Agent for Analyzing Running Readiness Based on User Health Data

Before You Run: Have You Asked If Your Body Is Actually Ready?

Ever laced up your shoes, stepped out the door, and felt like garbage within the first 200 meters? Your legs feel heavy, your heart rate is through the roof, and you end up walking home wondering what went wrong. I've been there more times than I'd like to admit. The hard truth is that running on pure enthusiasm without checking your body's signals is a recipe for frustration.

That's exactly why I want to talk about this Running Readiness Assessment Agent that analyzes your health data to tell you whether you're really good to go. It's not some mystical oracle—it's an open-source tool that translates your sleep, heart rate, and recovery metrics into actionable advice. You might be thinking: isn't that overkill for a simple run? But here's the thing—when you ignore what your body is quietly telling you, you're essentially flying blind. You have no idea how last night's poor sleep, today's elevated resting heart rate, or accumulated stress are silently sabotaging your performance.

What this Agent does is surprisingly straightforward: it turns your messy health data into a clear "readiness score" that helps you make smarter decisions. It won't boss you around with "you must run" or "you must rest." Instead, it gives you an objective picture so you get to decide. Sounds way better than guessing, right?

Three Core Components: Data Intake, Analysis Engine, and Personal Output

Let's break down how this system actually works. It's built around three layers, and each one plays a critical role. First up is the data collection layer, which pulls raw information from your smartwatch, sleep tracker, or health app. Privacy concerns? Don't worry—everything runs locally on your machine since this is an open-source project. No mysterious cloud uploads, no data mining.

Then comes the analysis engine, and this is where the magic happens. The system evaluates your readiness across multiple dimensions:

• Sleep quality: Deep sleep duration, sleep continuity, wake frequency
• Heart rate variability (HRV): The gold standard for measuring your nervous system recovery
• Resting heart rate: Is it elevated compared to your personal baseline?
• Recent training load: How much work have you done in the last 72 hours?
• Subjective feeling score: You can manually input how you feel today

Finally, the personalized output layer takes all those numbers and turns them into plain English. Instead of a spreadsheet, you get something like: "You're well recovered today—go for a moderate-intensity run" or "Your HRV is low—consider rest or light cross-training." Much easier to act on than a bunch of charts, wouldn't you agree?

Hands-On Code: Integrating the Readiness Agent Into Your Own Project

Enough theory—let's look at actual code. This Agent is built in Python on top of the health_agent_infra framework, and you can get it running with just a few lines. Here's a complete example you can try right now:

# Import required modules
from health_agent_infra.skills.running_readiness import RunningReadinessAgent
from health_agent_infra.models import UserHealthProfile

# Initialize a user health profile with sample data
profile = UserHealthProfile(
    user_id="runner_001",
    sleep_hours=7.5,
    deep_sleep_percentage=22,
    hrv_baseline=65,
    current_hrv=58,
    resting_hr_baseline=55,
    current_resting_hr=62,
    recent_training_load=350,  # Training load over the last 72 hours
    subjective_feeling="moderate"  # Options: good, moderate, poor
)

# Create the running readiness assessment Agent
agent = RunningReadinessAgent(profile)

# Run the assessment and get results
result = agent.assess_readiness()

# Print the output
print(f"Readiness Score: {result.score}/100")
print(f"Recommendation: {result.recommendation}")
print(f"Risk Factors: {result.risk_factors}")

# Sample output:
# Readiness Score: 72/100
# Recommendation: Your condition is acceptable today, but HRV is below baseline.
#                 Consider a low-intensity recovery run, keeping heart rate in Zone 2.
# Risk Factors: Recent training load is high, watch out for overtraining.

See? It's that simple. You just plug in your health data, and the Agent calculates a readiness score with actionable recommendations. The best part? You can modify the assessment logic yourself—tweak the weights of different metrics, add new data sources, or change the output format. That's the beauty of open-source: it's not a black box, it's a tool you can shape.

Decoding Your Score: When to Run and When to Hold Back

A score is useless if you don't know how to act on it. Based on my own experience, here's a quick reference table to help you decide what to do with your readiness score:

But here's the thing—this table is a guide, not a rulebook. Every body is different. You might score 65 but feel fantastic, and that's totally fine. The real skill is learning to combine the system's objective analysis with your own subjective intuition. Over time, you'll develop a feel for what works best for you.

From Data to Action: Making Every Run Count

After using this Agent for a few months, I've noticed something interesting. My biggest improvement wasn't in my pace or distance—it was in learning to respect my body's signals. I used to force myself to run every single day, which led to injuries and burnout. Now I check my readiness score first, and I make smarter choices. Some days I push hard; other days I take it easy or rest entirely. And you know what? My overall performance has actually improved because I'm not fighting against my own physiology.

If you're the kind of runner who loves data but doesn't want to be ruled by it, I genuinely recommend giving this open-source approach a try. Unlike commercial apps that lock you into their ecosystem, this one puts you in control. You own your data, you can tweak the algorithm, and you can adapt it as your understanding grows. Remember, running isn't about competing with others—it's about having a better conversation with your past self. And this Agent? It's the best translator for that conversation. So next time you're about to head out, take two minutes to ask it: "Hey, what's my body saying today?"