skills.rest
ruiyangruiyi
ruiyangruiyiCOMMUNITY
Explore all skills by this author →
GitHub

fitness-nutrition

Convert fitness questions into structured guidance using wger and USDA data.

Updated May 26, 2026
Search Tags:#macros#usda#tdee#nutrition tracking#body fat#workout planning#one rep max
One-click install
npx skills add https://github.com/ruiyangruiyi/hermes-agent --skill fitness-nutrition-ruiyangruiyi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fitness-nutrition
Source: https://github.com/ruiyangruiyi/hermes-agent/tree/main/optional-skills/health/fitness-nutrition
Command: npx skills add https://github.com/ruiyangruiyi/hermes-agent --skill fitness-nutrition-ruiyangruiyi

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

The Skill helps people design gym workouts and nutrition targets by turning exercise and food data into actionable numbers like calories, macros, BMI, TDEE, one-rep max estimates, and body fat %.

Core Features & Use Cases

  • Exercise discovery via wger: Search and retrieve exercise details by muscle group, category, equipment, or name.
  • Nutrition lookup via USDA FoodData Central: Find calories and macros (per 100g) for foods using an optional USDA_API_KEY (or DEMO_KEY).
  • Offline body composition and training calculators: Compute BMI, TDEE (Mifflin-St Jeor), estimated 1RM, macro splits, and body fat % (US Navy method) with pure Python/stdlib.

Quick Start

Ask for an example routine and targets: “Give me a cutting plan with estimated TDEE, calorie target, macro split, and 1RM estimates based on my stats.”

Frequently Asked Questions about fitness-nutrition

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

FAQPage Schema
How do I calculate TDEE and macro split for a cutting or bulking plan?▼

TDEE and macro split calculations use the Mifflin-St Jeor formula and pure Python stdlib math to compute your daily energy expenditure and target macronutrient ratios for cutting, maintenance, or bulking scenarios based on your body stats.

How do I search for exercises by muscle group and equipment for workout planning?▼

Exercise search queries the wger public API endpoints with English filtering (language=2, status=2) to retrieve structured exercise details by muscle group, category, equipment, or name for workout planning.

Can I look up food nutrition metrics and calories without an API key?▼

Food nutrition lookups query USDA FoodData Central using an optional USDA_API_KEY, automatically falling back to the DEMO_KEY to retrieve per-100g calorie and macro data if you do not provide one.

How do I estimate my body fat percentage and one rep max offline?▼

Body fat percentage is estimated using the US Navy method formula, while one rep max is calculated from lifting stats, both running entirely offline with standard Python math estimators.

Does this nutrition tracking approach work without external database dependencies?▼

Yes, body composition calculations for BMI, TDEE, macro splits, and body fat run offline using stdlib Python formulas, requiring no external dependencies, though exercise and food lookups need wger and USDA APIs.

What is the best way to get a complete fitness plan with calorie targets and exercise routines?▼

A complete fitness plan combines wger exercise discovery for routines, USDA FoodData Central for nutrition metrics, and offline calculators for TDEE, BMI, 1RM, macro splits, and body fat estimation into structured guidance.

Related Skills

Explore More Education & Research Skills→
huiferhuifer
3

profile

Manage user medical parameters and calculate BMI, BSA, and age.

Community
Basic
ItsJupiter000ItsJupiter000

meal-planner

Generate weekly meal plans with macro targets, shopping lists, and training schedules.

Community
Advanced
ldzhhxxldzhhxx
1

fitness-nutrition

Retrieve exercise and food data from wger and USDA FoodData Central APIs.

Community
Intermediate
nadicodeainadicodeai

fitness-nutrition

Compute BMI, TDEE, and macro targets from user fitness goals.

Official
Advanced