fitness-nutrition

Calculate fitness and nutrition targets using wger and USDA data.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/MarbleSodas/Mavis --skill fitness-nutrition-marblesodas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fitness-nutrition
Source: https://github.com/MarbleSodas/Mavis/tree/main/optional-skills/health/fitness-nutrition
Command: npx skills add https://github.com/MarbleSodas/Mavis --skill fitness-nutrition-marblesodas

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Fitness and nutrition planning often stalls users who need fast, accurate workout guidance and macro/calorie targets without manual calculations or scattered data sources.

Core Features & Use Cases

  • Exercise discovery from wger: Search and filter 690+ exercises by muscle group, category, equipment, or name, then surface concise details for training selection.
  • Nutrition lookup from USDA FoodData Central: Look up calories and macros (per 100g) for 380,000+ foods using DEMO_KEY or a higher-rate USDA_API_KEY, and retrieve detailed nutrient profiles by FDC ID.
  • Offline body composition & performance calculators: Compute BMI, TDEE (Mifflin-St Jeor), one-rep max estimates, macro splits for cut/maintain/bulk, and body fat % via the US Navy method using pure stdlib Python.

Quick Start

Ask the skill to calculate your TDEE and macro split for cutting from your weight, height, age, sex, and activity level.

Frequently Asked Questions about fitness-nutrition

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

FAQPage Schema
How do I calculate my TDEE and macro split for cutting or bulking?

You can calculate your TDEE and macro split by providing your weight, height, age, sex, and activity level to generate calorie and macro targets for cutting, bulking, or maintenance using the Mifflin-St Jeor offline formula.

Can I look up food macros and calories using the USDA database?

Yes, you can look up calories and macros per 100g for over 380,000 foods using the USDA FoodData Central API. You need a USDA_API_KEY or can use the default DEMO_KEY for retrieving detailed nutrient profiles by FDC ID.

How do I find exercises by muscle group and available equipment?

Find exercises by searching and filtering a database of over 690 entries by muscle group, category, equipment, or name. This surfaces concise exercise details to help you select training movements that match your available equipment.

How can I estimate my body fat percentage and one-rep max without online tools?

Estimate your body fat percentage using the US Navy method and calculate your one-rep max offline. These body-composition and performance formulas run on pure stdlib Python, requiring no external API connectivity to generate your metrics.

Do I need an API key to search exercises and plan workouts?

You do not need an API key for workout planning because exercise discovery uses wger exercise endpoints with English parameters and status filtering. An API key is only required for USDA nutrition lookup if you exceed the DEMO_KEY rate limits.

What is the best way to combine body composition estimates with daily calorie planning?

Combine body composition estimates with daily calorie planning by using offline BMI and US Navy body fat calculators alongside TDEE and macro formulas. This integration allows you to tailor your calorie and macro targets specifically to your cutting or bulking goals.