tommy-yw/runbookhermes/fitness-nutrition
Claude Code and agent skill by tommy-yw/runbookhermes
- community
Checking that the SKILL.md file is still in the repository.
Gym workout planner and nutrition tracker. Search 690+ exercises by muscle, equipment, or category via wger. Look up macros and calories for 380,000+ foods via USDA FoodData Central. Compute BMI, TDEE, one-rep max, macro splits, and body fat — pure Python, no pip installs. Built for anyone chasing gains, cutting weight, or just trying to eat better.
Install
npx vskill@latest install tommy-yw/runbookhermes/fitness-nutritionSKILL.md
The same SKILL.md was published earlier as tommy-yw/runbookhermes/fitness-nutrition.
Fitness & Nutrition
Expert fitness coach and sports nutritionist skill. Two data sources plus offline calculators — everything a gym-goer needs in one place.
Data sources (all free, no pip dependencies):
- wger (https://wger.de/api/v2/) — open exercise database, 690+ exercises with muscles, equipment, images. Public endpoints need zero authentication.
- USDA FoodData Central (https://api.nal.usda.gov/fdc/v1/) — US government nutrition database, 380,000+ foods.
DEMO_KEYworks instantly; free signup for higher limits.
Offline calculators (pure stdlib Python):
- BMI, TDEE (Mifflin-St Jeor), one-rep max (Epley/Brzycki/Lombardi), macro splits, body fat % (US Navy method)
When to Use
Trigger this skill when the user asks about:
- Exercises, workouts, gym routines, muscle groups, workout splits
- Food macros, calories, protein content, meal planning, calorie counting
- Body composition: BMI, body fat, TDEE, caloric surplus/deficit
- One-rep max estimates, training percentages, progressive overload
- Macro ratios for cutting, bulking, or maintenance
Procedure
Exercise Lookup (wger API)
All wger public endpoints return JSON and require no auth. Always add format=json and language=2 (English) to exercise queries.
Step 1 — Identify what the user wants:
- By muscle → use
/api/v2/exercise/?muscles={id}&language=2&status=2&format=json - By category → use
/api/v2/exercise/?category={id}&language=2&status=2&format=json - By equipment → use
/api/v2/exercise/?equipment={id}&language=2&status=2&format=json - By name → use
/api/v2/exercise/search/?term={query}&language=english&format=json - Full details → use
/api/v2/exerciseinfo/{exercise_id}/?format=json
Step 2 — Reference IDs (so you don't need extra API calls):
Exercise categories:
| ID | Category | |
|---|---|---|
| 8 | Arms | |
| 9 | Legs | |
| 10 | Abs | |
| 11 | Chest | |
| 12 | Back | |
| 13 | Shoulders | |
| 14 | Calves | |
| 15 | Cardio |
Muscles:
| ID | Muscle | ID | Muscle | |
|---|---|---|---|---|
| 1 | Biceps brachii | 2 | Anterior deltoid | |
| 3 | Serratus anterior | 4 | Pectoralis major | |
| 5 | Obliquus externus | 6 | Gastrocnemius | |
| 7 | Rectus abdominis | 8 | Gluteus maximus | |
| 9 | Trapezius | 10 | Quadriceps femoris | |
| 11 | Biceps femoris | 12 | Latissimus dorsi | |
| 13 | Brachialis | 14 | Triceps brachii | |
| 15 | Soleus |
Equipment:
| ID | Equipment | |
|---|---|---|
| 1 | Barbell | |
| 3 | Dumbbell | |
| 4 | Gym mat | |
| 5 | Swiss Ball | |
| 6 | Pull-up bar | |
| 7 | none (bodyweight) | |
| 8 | Bench | |
| 9 | Incline bench | |
| 10 | Kettlebell |
Step 3 — Fetch and present results:
Nutrition Lookup (USDA FoodData Central)
Uses USDA_API_KEY env var if set, otherwise falls back to DEMO_KEY. DEMO_KEY = 30 requests/hour. Free signup key = 1,000 requests/hour.
Offline Calculators
Use the helper scripts in scripts/ for batch operations, or run inline for single calculations:
python3 scripts/body_calc.py bmi <weight_kg> <height_cm>python3 scripts/body_calc.py tdee <weight_kg> <height_cm> <age> <M|F> <activity 1-5>python3 scripts/body_calc.py 1rm <weight> <reps>python3 scripts/body_calc.py macros <tdee_kcal> <cut|maintain|bulk>python3 scripts/body_calc.py bodyfat <M|F> <neck_cm> <waist_cm> [hip_cm] <height_cm>
See references/FORMULAS.md for the science behind each formula.
Pitfalls
- wger exercise endpoint returns all languages by default — always add
language=2for English - wger includes unverified user submissions — add
status=2to only get approved exercises - USDA
DEMO_KEYhas 30 req/hour — addsleep 2between batch requests or get a free key - USDA data is per 100g — remind users to scale to their actual portion size
- BMI does not distinguish muscle from fat — high BMI in muscular people is not necessarily unhealthy
- Body fat formulas are estimates (±3-5%) — recommend DEXA scans for precision
- 1RM formulas lose accuracy above 10 reps — use sets of 3-5 for best estimates
- wger's
exercise/searchendpoint usestermnotqueryas the parameter name
Verification
After running exercise search: confirm results include exercise names, muscle groups, and equipment. After nutrition lookup: confirm per-100g macros are returned with kcal, protein, fat, carbs. After calculators: sanity-check outputs (e.g. TDEE should be 1500-3500 for most adults).
Quick Reference
| Task | Source | Endpoint | |
|---|---|---|---|
| Search exercises by name | wger | GET /api/v2/exercise/search/?term=&language=english | |
| Exercise details | wger | GET /api/v2/exerciseinfo/{id}/ | |
| Filter by muscle | wger | GET /api/v2/exercise/?muscles={id}&language=2&status=2 | |
| Filter by equipment | wger | GET /api/v2/exercise/?equipment={id}&language=2&status=2 | |
| List categories | wger | GET /api/v2/exercisecategory/ | |
| List muscles | wger | GET /api/v2/muscle/ | |
| Search foods | USDA | GET /fdc/v1/foods/search?query=&dataType=Foundation,SR Legacy | |
| Food details | USDA | GET /fdc/v1/food/{fdcId} | |
| BMI / TDEE / 1RM / macros | offline | python3 scripts/body_calc.py |
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingoptional-skills/health/fitness-nutrition/SKILL.md
Popularity
- Repository stars
- 547
- Repository forks
- 41
- 7-day trend score
- 32
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/tommy-yw/runbookhermes/fitness-nutrition)