Grocery List Optimizer

A smart grocery planning skill that generates shopping lists organized by store aisle, cross-referenced with your weekly meal plan, budget constraints, and current pantry inventory. Supports multi-platform integration with AnyList, Todoist, Apple Reminders, and Google Keep for seamless mobile shopping across any grocery store.

Supported Platforms & Integrations

Platform	Integration Type	Features
AnyList	Export	Aisle-organized lists with quantity and unit formatting
Apple Reminders	Checklist Export	Grouped shopping lists with checkboxes and store tags
Todoist	Task Export	Grocery project with subtasks organized by store section
Google Keep	Plain Text	Checkbox lists optimized for mobile shopping
Google Sheets	CSV Export	Budget tracking with price estimates and running totals
Notion	Database Export	Pantry inventory database with expiration tracking

When to Use This Skill

• Use this when you have a meal plan for the week and need to generate a consolidated shopping list

• Use this when you want to stay within a weekly grocery budget without sacrificing meal quality

• Use this when shopping at multiple stores and need separate optimized lists per store

• Use this when your pantry is partially stocked and you only need to buy what is missing

• Use this when cooking for guests or events and need to scale recipes and combine ingredient lists

• Use this when you want to reduce food waste by buying exact quantities needed for planned meals

• Consider alternatives when you need real-time grocery price comparison across delivery services

• Consider alternatives when you need dietary analysis or nutritional macro counting

• Consider alternatives when you want automatic grocery delivery ordering through Instacart or similar

Quick Start

Copy
# .claude/skills/grocery-list-optimizer.yml
name: Grocery List Optimizer
trigger: "grocery list"
context:
  household_size: 4
  weekly_budget: 150
  primary_store: "Kroger"
  dietary_restrictions: []
  pantry_staples: [rice, pasta, olive-oil, salt, pepper, garlic]

First Run Example:

User: Generate a grocery list for these meals this week:
Mon: Chicken stir fry, Tue: Tacos, Wed: Pasta carbonara,
Thu: Sheet pan salmon, Fri: Homemade pizza

Expected Output:

## Weekly Grocery List — March 16-22, 2026
Meals: 5 dinners | Household: 4 | Budget: $150

### Produce
- [ ] Broccoli, 2 crowns — stir fry
- [ ] Bell peppers, 3 (red, green, yellow) — stir fry, tacos
- [ ] Romaine lettuce, 1 head — tacos
- [ ] Tomatoes, 4 medium — tacos, pizza
- [ ] Lemon, 2 — salmon, carbonara
- [ ] Fresh basil, 1 bunch — pizza, pasta
- [ ] Yellow onion, 2 — stir fry, tacos, pizza

### Meat & Seafood
- [ ] Chicken breast, 1.5 lbs — stir fry
- [ ] Ground beef, 1 lb (80/20) — tacos
- [ ] Salmon fillets, 4 (6oz each) — sheet pan
- [ ] Pancetta, 4 oz — carbonara

### Dairy & Eggs
- [ ] Eggs, 1 dozen — carbonara
- [ ] Parmesan, 4 oz wedge — carbonara, pizza
- [ ] Mozzarella, 8 oz fresh — pizza
- [ ] Sour cream, 8 oz — tacos

### Bakery & Bread
- [ ] Pizza dough, 2 balls — pizza (or make from pantry flour)
- [ ] Taco shells, 12-pack — tacos

### Pantry (check stock first)
- [ ] Soy sauce — stir fry (SKIP if in pantry)
- [ ] Taco seasoning — tacos

**Estimated Total: $92-118**
**Under Budget by: $32-58**

Items already in pantry (not listed): rice, pasta, 
olive oil, salt, pepper, garlic

Advanced Configuration

Platform-Specific Setup:

Copy
# Store-specific aisle mapping
store_layout:
  store_name: "Kroger"
  aisle_order: [produce, deli, meat, dairy, bakery, frozen, pantry, beverages]
  custom_aisles: {}

# Budget tracking
budget:
  weekly_limit: 150
  price_estimation: regional
  track_running_total: true
  alert_threshold: 0.9

Parameter	Type	Default	Description
household_size	int	4	Number of people eating planned meals
weekly_budget	int	150	Maximum weekly grocery spend in dollars
primary_store	string	"generic"	Primary grocery store for aisle organization
dietary_restrictions	array	[]	vegetarian, vegan, gluten-free, dairy-free, nut-free, kosher
pantry_staples	array	[]	Items always in stock to exclude from shopping lists
prefer_organic	bool	false	Prioritize organic options in recommendations
bulk_buying	bool	false	Suggest bulk quantities for frequently used items
unit_system	string	imperial	imperial or metric for quantities
coupon_awareness	bool	false	Note common coupon categories for potential savings
leftover_planning	bool	true	Suggest using leftovers from earlier meals in later ones
output_format	string	markdown	markdown, anylist, todoist, csv, plain-text

Core Concepts

Concept	Description
Ingredient Consolidation	Combines identical ingredients across multiple recipes into single quantities
Aisle Organization	Sorts items by store section to minimize backtracking during shopping
Pantry Deduction	Subtracts items already in stock from the shopping list automatically
Budget Tracking	Estimates costs per item and flags when the list approaches budget limits
Waste Reduction	Calculates exact quantities needed to minimize unused perishable ingredients

+------------------+     +------------------+     +------------------+
|  Meal Plan       |---->|  Recipe Parser   |---->|  Ingredient      |
|  (weekly meals,  |     |  (extract items, |     |  Consolidator    |
|   servings)      |     |   quantities)    |     |  (merge, scale)  |
+------------------+     +------------------+     +------------------+
                                                          |
                                                          v
+------------------+     +------------------+     +------------------+
|  Shopping Export |<----|  Budget Checker  |<----|  Aisle Sorter    |
|  (AnyList, etc.) |     |  (estimate cost, |     |  (store layout,  |
|                  |     |   flag overages) |     |   section groups)|
+------------------+     +------------------+     +------------------+

Workflow Examples

Scenario 1: Multi-Store Optimization

Input: "Split my grocery list between Costco (bulk staples) 
and Trader Joe's (specialty items). Same meal plan."

Output:
## Costco List (Buy in Bulk)
- [ ] Chicken breast, 5 lb bag — covers 2+ weeks
- [ ] Rice, 10 lb bag — pantry restock
- [ ] Eggs, 2 dozen — carbonara + breakfasts
Estimated: $38-45

## Trader Joe's List (Fresh & Specialty)
- [ ] Fresh mozzarella, 8 oz
- [ ] Pancetta, 4 oz
- [ ] Pizza dough, 2 pack
- [ ] Fresh basil
Estimated: $22-30

**Combined Total: $60-75 (saved $30+ vs single store)**

Scenario 2: Guest Dinner Scaling

Input: "Having 8 guests for Saturday dinner. Making 
lasagna, Caesar salad, garlic bread, and tiramisu."

Output:
## Dinner Party Grocery List — 10 servings
(Scaled for 8 guests + 2 hosts)

[Full ingredient list with quantities scaled 
for 10 servings, organized by store section, 
with make-ahead timeline notes]

Estimated Cost: $65-85

Scenario 3: Budget Crunch Week

Input: "Only $60 for groceries this week. Family of 4. 
Need 5 dinners. What can I make?"

Output:
## Budget Week — $60 for 5 Dinners (Family of 4)

**Suggested Meals:**
1. Black bean quesadillas with rice ($7)
2. Pasta aglio e olio with side salad ($6)
3. Chicken thigh stir fry with vegetables ($11)
4. Lentil soup with crusty bread ($5)
5. Egg fried rice with frozen vegetables ($5)

**Total Estimated: $34-42 (leaves $18-26 for lunches)**
[Complete shopping list follows]

Best Practices

• Keep your pantry staples list updated. The skill deducts pantry items automatically, but only if the list is accurate. Spend two minutes checking your pantry before generating each weekly list to avoid buying duplicates.

• Plan meals that share ingredients. Requesting meals with overlapping ingredients like chicken in two recipes or the same vegetables across multiple dishes reduces waste and cost. The skill highlights these overlaps.

• Check quantities before shopping, not at the store. Review the consolidated list at home where you can verify pantry stock. Adjusting at the store leads to impulse purchases that blow your budget.

• Use the leftover planning feature. Monday's roasted chicken becomes Wednesday's chicken salad. The skill can chain meals to use ingredients efficiently across the week, reducing both waste and shopping volume.

• Track actual spending against estimates over time. The CSV export includes columns for estimated and actual prices. After a month of tracking, your regional price data becomes highly accurate for future budget planning.

Common Issues

• Ingredient quantities seem too large or too small. Verify your household_size setting and confirm the serving count per recipe. The skill defaults to standard recipe yields which may differ from your family's appetite.

• Aisle organization does not match my store layout. Customize the store_layout configuration with your specific store's section order. Most stores follow a perimeter-to-center pattern, but layouts vary significantly.

• Budget estimates are inaccurate for my area. Grocery prices vary significantly by region and store. Run the tracking spreadsheet for two to three weeks and the skill will calibrate to your actual spending patterns.

Privacy & Data Handling

• Local Processing: All grocery lists are generated locally. Your meal plans, dietary information, and budget details are never shared with grocery stores or third-party services.
• Data Retention: Shopping lists exist only in your current session and exported files. No dietary or purchasing data persists externally between sessions.
• Export Options: Export as Markdown checklists, AnyList imports, Todoist tasks, CSV spreadsheets, or plain text. All files are saved locally on your device.
• No Purchase Tracking: The skill does not connect to loyalty programs, grocery delivery services, or advertising networks. Your shopping data remains entirely private.