weekly-meal-planner

Plan weekly dinners from Home Assistant calendars and Mealie recipes.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/DisruptionEngineer/build-useful-skills --skill weekly-meal-planner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: weekly-meal-planner
Source: https://github.com/DisruptionEngineer/build-useful-skills/tree/main/weekly-meal-planner
Command: npx skills add https://github.com/DisruptionEngineer/build-useful-skills --skill weekly-meal-planner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinating weekly dinners across a busy household involves juggling calendars, dietary preferences, and shopping, leading to decision fatigue and missed meals. This Skill automates the planning process by analyzing Home Assistant calendars and Mealie-integrated recipes to generate 3–5 dinners per week customized for two servings, while flagging leftovers when density suggests them.

Core Features & Use Cases

  • Calendar-aware planning: scores each day based on family schedules, work commitments, and leftovers detection to minimize last-minute decisions.
  • Mealie integration: imports approved recipes and assigns meals to targeted days, generating scaled shopping lists.
  • Discord-assisted validation: surfaces recipe cards for reaction-based approval and revision to adapt weekly menus.
  • Morning alerts: posts crockpot and thaw reminders to keep dinner prep on schedule.
  • Shopping optimization: produces a 2-serving grocery list aligned with substitutions and pantry notes.

Quick Start

Start a new meal planning week by triggering the planner in Home Assistant with your configured Mealie and preference data.

Frequently Asked Questions about weekly-meal-planner

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

FAQPage Schema
How do I automate weekly meal planning using Home Assistant calendars?

Automated weekly meal planning analyzes Home Assistant calendars and Mealie recipes to schedule 3–5 dinners based on family availability. It scores days according to work commitments and leftovers detection to minimize last-minute decisions.

Can I generate a shopping list from Mealie recipes for two servings?

You can generate a shopping list from Mealie recipes scaled for two servings. The planner imports approved recipes, assigns meals to targeted days, and outputs a grocery list aligned with pantry notes and substitutions.

How does Discord reaction-based validation work for meal suggestions?

Discord-assisted validation surfaces recipe cards to your channel for reaction-based approval. You react to proposed dinner options to adapt and finalize the weekly menu before the planner commits the schedule.

Do I need a Mealie API and Home Assistant instance to use this meal planner?

You need a Home Assistant instance, Mealie API access, and configured calendars with preference data. These dependencies are required to analyze family schedules, import approved recipes, and generate optimized weekly dinner plans.

What is calendar-aware meal planning and how does it handle leftovers?

Calendar-aware meal planning scores each day based on family schedules and work commitments to assign dinners. It flags leftovers when meal density suggests them, ensuring you avoid unnecessary cooking and food waste.

How do I get crockpot and thaw reminders for scheduled dinners?

The planner posts crockpot and thaw reminders as morning alerts to keep dinner prep on schedule. These automated notifications ensure your ingredients are ready for the meals assigned to your Home Assistant calendars.