fitness-nutrition

Search exercises and food nutrition data via wger and USDA APIs, and compute fitness metrics offline.

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/episvr/USTB-2026-SummerInternship --skill fitness-nutrition-episvr
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fitness-nutrition
Source: https://github.com/episvr/USTB-2026-SummerInternship/tree/main/hermes-config/optional-skills/health/fitness-nutrition
Command: npx skills add https://github.com/episvr/USTB-2026-SummerInternship --skill fitness-nutrition-episvr

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Planning workouts and tracking nutrition requires jumping between exercise databases, calorie calculators, and macro spreadsheets. This Skill consolidates exercise lookup, food nutrition search, and body-metric calculations into one workflow backed by free public APIs and offline Python calculators. ## Core Features & Use Cases - Exercise Search via wger: Query 690+ exercises by muscle group, equipment, category, or name, with full details including primary/secondary muscles and instructions. - Nutrition Lookup via USDA FoodData Central: Search 380,000+ foods for per-100g calories, protein, fat, and carbs, with a DEMO_KEY fallback when no API key is configured. - Offline Body Calculators: Compute BMI, TDEE (Mifflin-St Jeor), one-rep max (Epley/Brzycki/Lombardi), macro splits for cut/maintain/bulk, and body fat percentage (US Navy method) using pure stdlib Python. - Use Case: A user cutting weight asks for their TDEE at moderate activity, a 40/30/30 macro split at a 500 kcal deficit, and high-protein food options — all answered in one session. ## Quick Start Ask the assistant to calculate your TDEE and macro split for fat loss, then search for dumbbell chest exercises and the macros of chicken breast.

Frequently Asked Questions about fitness-nutrition

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

FAQPage Schema
How do I search exercises by muscle group or equipment?▼

Query the wger API exercise endpoint with filters like muscles={id}, category={id}, or equipment={id}, always adding language=2 and status=2 for approved English results. Use the exercise/search endpoint with a term parameter to find exercises by name.

How to look up calories and macros for a food?▼

Search the USDA FoodData Central foods/search endpoint with your query, which returns per-100g values for calories, protein, fat, and carbohydrates. The nutrition_search.py script handles this and falls back to DEMO_KEY if USDA_API_KEY is not set.

Do I need an API key for USDA nutrition data?▼

No key is strictly required since DEMO_KEY works instantly with a 30 requests-per-hour limit. For higher limits of 1,000 requests per hour, sign up for a free USDA_API_KEY and set it as an environment variable.

How accurate are the one-rep max and body fat calculations?▼

One-rep max formulas (Epley, Brzycki, Lombardi) are most accurate at 10 reps or fewer, so use sets of 3-5 reps. The US Navy body fat method has ±3-5% error compared to DEXA scans and should be treated as an estimate.

Why does the wger exercise search return no or wrong-language results?▼

The wger API returns all languages by default, so always include language=2 for English. It also includes unverified user submissions, so add status=2 to restrict results to approved exercises, and use term rather than query as the search parameter.