fitness-nutrition

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

Updated May 3, 2026
One-click install
npx skills add https://github.com/80portisfound/vibe-learning --skill fitness-nutrition-80portisfound
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fitness-nutrition
Source: https://github.com/80portisfound/vibe-learning/tree/main/packages/hermes/optional-skills/health/fitness-nutrition
Command: npx skills add https://github.com/80portisfound/vibe-learning --skill fitness-nutrition-80portisfound

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 using free public APIs and offline Python calculators. ## Core Features & Use Cases - Exercise Search: Query 690+ exercises from the wger database by muscle group, equipment, category, or name, with full details including instructions and images. - Nutrition Lookup: Search 380,000+ foods in USDA FoodData Central for calories, protein, fat, carbs, fiber, and full nutrient profiles per 100g. - 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 planning a cut asks for their TDEE at 80kg with moderate activity, gets a 500 kcal deficit target with a 40/30/30 macro split, then looks up protein content of chicken breast and finds chest exercises for dumbbells only. ## Quick Start Ask the assistant to calculate your TDEE and macro split for cutting, then search for high-protein foods and dumbbell chest exercises.

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=4, equipment=3, or category=11, always adding language=2 and status=2 for approved English results. You can also search by name using the exercise/search endpoint with the term parameter.

How do I look up calories and macros for a food?▼

Use the USDA FoodData Central foods/search endpoint with your query, which returns calories, protein, fat, and carbs per 100g. The included nutrition_search.py script handles this and falls back to DEMO_KEY if no USDA_API_KEY is set.

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

No key is strictly required since DEMO_KEY works immediately with a 30 requests per hour limit. For 1,000 requests per hour, sign up free at the USDA FoodData Central site and set the USDA_API_KEY environment variable.

How accurate are the TDEE and body fat calculations?▼

TDEE uses the Mifflin-St Jeor equation, the most accurate BMR predictor for general populations per the ADA. Body fat uses the US Navy circumference method with ±3-5% accuracy compared to DEXA scans, so treat results as estimates.

Why does the one-rep max estimate seem off for high reps?▼

The Epley, Brzycki, and Lombardi formulas lose accuracy above 10 reps. For reliable 1RM estimates, use sets of 3-5 reps, and note the script averages all three formulas for a more stable result.

Does this skill require installing Python packages?▼

No pip installs are needed. All calculators and API scripts use only the Python standard library, with curl and python3 as the only required system commands.