fitness-nutrition

Query exercise and nutrition data from wger and USDA APIs and calculate body metrics offline.

Updated Aug 22, 2026
One-click install
npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill fitness-nutrition-vivekgoquest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fitness-nutrition
Source: https://github.com/vivekgoquest/hermes-agent-stable/tree/main/optional-skills/health/fitness-nutrition
Command: npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill fitness-nutrition-vivekgoquest

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, food lookup tools, and fitness calculators. This Skill consolidates exercise search, food macro lookups, and body metric calculations into one workflow using free public APIs and offline Python scripts. ## Core Features & Use Cases - Exercise Database Access: Search 690+ exercises from wger by name, muscle group, category, or equipment, with full details including instructions and images. - Nutrition Lookup: Query the USDA FoodData Central database of 380,000+ foods for calories, protein, fat, and carbs per 100g, using DEMO_KEY or a free API key. - Offline Calculators: Compute BMI, TDEE (Mifflin-St Jeor), one-rep max (Epley/Brzycki/Lombardi), macro splits for cutting or bulking, and body fat percentage (US Navy method) with pure stdlib Python. - Use Case: A user asks for a chest workout with dumbbells and a 500-kcal deficit meal plan. The Skill filters wger for chest exercises with dumbbell equipment, calculates their TDEE and macro targets, and looks up food macros to build the plan. ## Quick Start Ask the fitness skill to calculate your TDEE and macro split for fat loss, then suggest exercises for a specific muscle group.

Frequently Asked Questions about fitness-nutrition

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

FAQPage Schema
How do I search for exercises by muscle group using the wger API?▼

Query the wger exercise endpoint with the muscles parameter, such as /api/v2/exercise/?muscles=4&language=2&status=2&format=json. Always include language=2 for English results and status=2 to filter out unverified user submissions.

How to look up calories and macros for a food with the USDA API?▼

Use the FoodData Central search endpoint /fdc/v1/foods/search with your query and dataType=Foundation,SR Legacy. Results return calories, protein, fat, and carbs per 100g, so scale values to your actual portion size.

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

No signup is required since DEMO_KEY works immediately at 30 requests per hour. For higher limits of 1,000 requests per hour, set the USDA_API_KEY environment variable after free registration at the FoodData Central site.

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

One-rep max formulas (Epley, Brzycki, Lombardi) are most accurate at 10 reps or fewer, so use sets of 3-5 reps. US Navy body fat estimates carry ±3-5% error compared to DEXA scans, which remain the precision standard.

Why does the wger exercise search return non-English results?▼

The wger API returns all languages by default. Add language=2 to exercise queries and language=english to the search endpoint, and note that the search endpoint uses the parameter name term rather than query.