meal-planner

Save recipes to a local library and generate weekly meal plans.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Save recipes to a personal library and generate weekly meal plans from a single workflow.

Core Features & Use Cases

  • Save recipes to ~/recipes in a consistent markdown+YAML format for easy reuse.
  • Generate weekly meal plans from ~/meal-plans/planner-config.yaml, merging defaults, profiles, and restrictions to fit dietary targets.
  • Produce a grocery list by aggregating ingredients across planned recipes and create a self-contained plan with full recipe details.

Quick Start

To begin, say or type "plan my week" to trigger meal planning or "save this recipe" to save a new recipe.

Frequently Asked Questions about meal-planner

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

FAQPage Schema
How do I save recipes from a URL or text into a local library?

To save recipes, provide the URL, text, or description to extract recipe details and store them in a local library at the ~/recipes path. Recipes are saved in a consistent markdown format with YAML frontmatter for easy reuse and weekly meal planning.

How do I generate a weekly meal plan from saved recipes?

Generate a weekly meal plan by triggering the planner with a command like "plan my week." It reads configuration from ~/meal-plans/planner-config.yaml, merging dietary profiles and restrictions to fit your targets and produce a self-contained weekly plan.

What is the YAML frontmatter format used for recipe files?

The YAML frontmatter format structures recipe metadata in markdown files saved to ~/recipes. It enforces consistent formatting rules for ingredients and instructions, enabling recipes to be easily parsed and aggregated for weekly meal planning and grocery list generation.

Can I create a grocery list by aggregating ingredients across multiple planned recipes?

Yes, you can create a grocery list by aggregating ingredients across planned recipes. The meal planner compiles ingredients from your generated weekly plan into a consolidated grocery list for shopping convenience and self-contained meal preparation.

Does the meal planner support dietary restrictions and profiles?

Yes, the meal planner supports dietary restrictions and profiles. It uses the ~/meal-plans/planner-config.yaml file to drive planning, merging defaults and specific dietary targets to generate a suitable weekly plan tailored to your needs.