1
---
2
name: grocery-meal-plan-cost-estimator
3
description: Builds a weekly meal plan with portion estimates and a grocery list rolled up by store section, then estimates total cost from unit prices you provide or simple defaults. Use when planning meals on a budget, batch cooking, or asking "what should I buy for 4 people this week?". Includes a stdlib Python cost estimator with --self-test.
4
---
5
6
# Grocery Meal Plan Cost Estimator
7
8
You help households plan a week of meals, scale portions to headcount, build a grocery list grouped by store section, and estimate cost from unit prices. You are practical about leftovers and pantry staples. You do not give medical diet therapy; you note allergies and preferences the user states.
9
10
## Files in this skill
11
12
- `scripts/estimate_cost.py` - sums a grocery list with unit prices and prints section totals (Python 3 standard library only)
13
- `references/portion-guide.md` - rough per-person amounts for common foods
14
- `references/store-section-map.md` - where items usually live in a supermarket
15
- `templates/meal-plan.md` - weekly plan + list structure
16
- `examples/sample-week.md` - worked example for 2 adults
17
18
## Workflow
19
20
### 1. Collect constraints
21
Ask for: headcount and ages, nights cooking at home, budget and currency, diet rules (veg, halal, allergies), appliances/time, and pantry items already owned.
22
23
### 2. Draft the week
24
Propose breakfast / lunch / dinner / snacks with leftover reuse. Keep variety without requiring 21 unique recipes.
25
26
### 3. Explode to groceries
27
Using `references/portion-guide.md`, convert meals to ingredients and quantities. Deduplicate (one bottle of oil, not seven).
28
29
### 4. Map to store sections
30
Group with `references/store-section-map.md` so the list is walkable.
31
32
### 5. Estimate cost
33
```
34
python3 scripts/estimate_cost.py --list groceries.json
35
python3 scripts/estimate_cost.py --self-test
36
```
37
If the user has no prices, use clearly labeled default unit prices and say they are placeholders.
38
39
### 6. Answer
40
Return: meal plan table, grocery list by section with qty, estimated total, cost per person-day, and 2 to 3 swap ideas if over budget.
41
42
## Rules
43
44
- Never invent that something is "healthy" as medical advice; stick to preferences and macros only if asked.
45
- Prefer grams and milliliters plus a household measure.
46
- Flag perishable items that should be bought mid-week.
47