meal-planner

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

2|Updated Apr 11, 2026
One-click install
npx skills add https://github.com/kvm9-dev/susanoo --skill meal-planner-kvm9-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: meal-planner
Source: https://github.com/kvm9-dev/susanoo/tree/main/.local/secondary_skills/meal-planner
Command: npx skills add https://github.com/kvm9-dev/susanoo --skill meal-planner-kvm9-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps users turn nutrition and fitness goals into a complete weekly meal plan with macro targets, a consolidated shopping list, and a training schedule.

Core Features & Use Cases

  • Macro-calculated meal plans: Computes energy targets (TDEE) using Mifflin-St Jeor or Katch-McArdle, then sets evidence-based protein/fat targets and fills remaining calories with carbs and fiber targets.
  • Shopping list generation: Aggregates ingredients across all days and rounds quantities into practical purchasable units.
  • Nutrition paired with training: Provides a fitness split template (beginner/intermediate/advanced) aligned with the nutrition phase, including volume and recovery guidance.
  • React web app output requirement: Produces an interactive week-by-week React + Vite app with calendar grid, meal cards, macro bars, shopping list, prep guide, macro dashboard, and training schedule.

Quick Start

Generate a weekly meal plan for fat loss using my goal, sex, age, height, weight, activity level, dietary restrictions, meals-per-day preference, cooking time, and budget.

Frequently Asked Questions about meal-planner

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

FAQPage Schema
How do I generate a weekly meal plan with macro targets and a shopping list?

To generate a weekly meal plan, provide a YAML profile with your sex, age, height, weight, activity level, dietary restrictions, and goals. The tool calculates BMR and TDEE, then outputs an interactive React web app with macro targets and an aggregated shopping list.

How does TDEE calculation work for setting protein, fat, and carb targets?

TDEE calculation uses the Mifflin-St Jeor or Katch-McArdle equations to determine your daily energy expenditure. It then sets evidence-based protein and fat targets, filling remaining calories with carbs and fiber to align with your fat loss, maintenance, or muscle gain goals.

Can I get a fitness schedule aligned with my nutrition plan for muscle gain?

Yes, the meal planner generates a fitness schedule aligned with your nutrition phase. It provides a beginner, intermediate, or advanced training split template that includes volume and recovery guidance to match your muscle gain or fat loss targets.

Do I need to provide detailed dietary restrictions and budget info for meal planning?

Yes, you should define dietary restrictions, meals-per-day preference, cooking time, and budget in your YAML profile input. This ensures the generated weekly meal plan, ingredient aggregation, and shopping list quantities fit your practical constraints.

What format does the generated meal plan and macro dashboard output use?

The output is an interactive React and Vite web application. It features a week-view calendar grid, expandable meal cards, macro bars, a shopping list, prep guide, macro dashboard, and the training schedule for visualizing your nutrition plan.

What is the best way to aggregate ingredients into practical shopping list quantities?

The best way is to let the planner aggregate ingredients across all days of the weekly meal plan automatically. It rounds the calculated ingredient quantities into practical purchasable units, creating a consolidated shopping list from your macro-calculated meals.