skills.rest
azaanaliraza
azaanalirazaCOMMUNITY
Explore all skills by this author →
GitHub

fitness-nutrition

Search exercises and food nutrition data, then compute BMI, TDEE, one-rep max, and macro splits.

Updated Apr 18, 2026
Search Tags:#macros#fitness#workout#nutrition#exercise#tdee#calories
One-click install
npx skills add https://github.com/azaanaliraza/operarius --skill fitness-nutrition-azaanaliraza
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fitness-nutrition
Source: https://github.com/azaanaliraza/operarius/tree/main/src-tauri/bin/hermes/optional-skills/health/fitness-nutrition
Command: npx skills add https://github.com/azaanaliraza/operarius --skill fitness-nutrition-azaanaliraza

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 food label lookups. This Skill consolidates exercise search, food macro lookup, and body composition math 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, equipment, category, or name, with reference ID tables so no extra API calls are needed for filtering. - Nutrition Lookup via USDA FoodData Central: Search 380,000+ foods for per-100g calories, protein, fat, and carbs, using DEMO_KEY or a free USDA_API_KEY for higher rate limits. - 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) with pure stdlib Python. - Use Case: A user asks for a chest workout with dumbbells and a cutting meal plan. The Skill filters wger for chest exercises with dumbbell equipment, then calculates their TDEE and a 40/30/30 macro split at a 500 kcal deficit. ## Quick Start Ask the assistant to find dumbbell chest exercises and calculate your TDEE and cutting macros for your weight, height, age, 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 search exercises by muscle group or equipment?▼

Query the wger API exercise endpoint with filters like muscles=4, category=11, or equipment=3, always adding language=2 and status=2 for approved English results. The Skill includes reference tables mapping IDs to muscles, categories, and equipment so no extra lookup calls are needed.

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

Search the USDA FoodData Central API with the food name to get per-100g calories, protein, fat, and carbs. The nutrition_search.py script accepts multiple foods at once 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 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 wger exercise search return no or wrong results?▼

The search endpoint uses the parameter name term, not query, and results default to all languages unless language=2 is added. Unverified user submissions also appear unless you filter with status=2 for approved exercises only.

When is the one-rep max estimate unreliable?▼

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

Related Skills

Explore More Personal & Entrepreneur Skills→
tamnguyentommy-rgbtamnguyentommy-rgb
2

meal-planner

Generate personalized meal plans with macros, shopping lists, and prep guides.

Community
Advanced
redwan7anime-delredwan7anime-del

meal-planner

Calculate macros, generate weekly meal plans, and pair nutrition with fitness schedules.

Community
Advanced
hvkshetryhvkshetry
15

nutrition-tracking

Track daily nutrition intake and analyze macronutrients against targets via the wger API.

Community
Intermediate
karaage0703karaage0703
136

xs:health-advisor

Log meals and exercises, estimate calories, and generate weekly health reports.

Community
Intermediate