skills.rest
JamesFincher
JamesFincherCOMMUNITY
Explore all skills by this author →
GitHub

fitness-nutrition

Compute fitness targets and nutrition macros from exercise and USDA food data.

Updated May 4, 2026
Search Tags:#body composition#macro tracking#USDA FoodData Central#workout planning#exercise database#nutrition lookup#TDEE calculators
One-click install
npx skills add https://github.com/JamesFincher/gengar --skill fitness-nutrition-jamesfincher
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fitness-nutrition
Source: https://github.com/JamesFincher/gengar/tree/main/optional-skills/health/fitness-nutrition
Command: npx skills add https://github.com/JamesFincher/gengar --skill fitness-nutrition-jamesfincher

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps you turn fitness and nutrition questions into actionable numbers—so you can plan workouts and meals using consistent calculators and trusted free datasets.

Core Features & Use Cases

  • Workout exercise discovery (wger API): Search and filter exercises by muscle, category, equipment, or name, then view detailed exercise info.
  • Nutrition lookup (USDA FoodData Central): Find foods by name and pull per-100g calories and macros using the USDA API (DEMO_KEY supported with lower limits).
  • Offline body & training calculators: Compute BMI, TDEE, estimated one-rep max, macro splits, and body-fat % using pure Python stdlib formulas.

Use case: You want a leg workout plus a calorie target—search for quad-focused exercises, look up macros for your planned foods, and compute TDEE and your cut/bulk macro split to guide your week.

Quick Start

Use the fitness-nutrition skill to calculate your macros for a cutting diet by asking: "Calculate my TDEE and daily macro split for a 75 kg, 175 cm, 30-year-old male with activity level 3, and estimate my 1RM for 100 kg x 5."

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 daily macro split for a cutting or bulking diet?▼

To calculate your TDEE and macro split, provide your weight, height, age, gender, and activity level to get your daily calorie target and protein, carb, and fat grams for cutting or bulking.

How do I look up per-100g calories and macros for specific foods using the USDA database?▼

You look up per-100g calories and macros by searching food names via the USDA FoodData Central API, which returns detailed nutrient profiles using a USDA_API_KEY or the DEMO_KEY fallback.

Can I filter the exercise database by muscle group and available gym equipment?▼

You can filter exercises by muscle group, category, and equipment using the wger exercise API, allowing you to retrieve detailed workout movements tailored to your available gym setup.

Do I need an API key to access the USDA FoodData Central nutrition database?▼

You do not need an API key to access the USDA FoodData Central database; the skill automatically falls back to the DEMO_KEY for nutrition lookups, though it supports a custom USDA_API_KEY for higher limits.

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

You estimate your one-rep max by inputting a weight and rep count, and calculate body fat percentage using pure Python standard library formulas, requiring no external API connectivity.

Related Skills

Explore More Education & Research Skills→
HarriesHarries

fitness-nutrition

Plan workouts and track nutrition using wger and USDA APIs.

Community
Advanced
koya-altkoya-alt

meal-planner

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

Community
Advanced
frxiaobeifrxiaobei
26

nutrition-analyzer

Analyze nutrition data to identify patterns and generate personalized dietary guidance.

Community
Advanced
SethyPagnaSethyPagna

fitness-nutrition

Plan workouts and nutrition targets using wger and USDA FoodData Central.

Community
Advanced