# Send Meal Planner to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "meal-planner",
    "name": "Meal Planner",
    "source": "tencent",
    "type": "skill",
    "category": "内容创作",
    "sourceUrl": "https://clawhub.ai/ivangdavila/meal-planner",
    "canonicalUrl": "https://clawhub.ai/ivangdavila/meal-planner",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/meal-planner",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=meal-planner",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "budget-tips.md",
      "meal-prep.md",
      "memory-template.md",
      "setup.md",
      "shopping-guide.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "meal-planner",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T03:36:34.530Z",
      "expiresAt": "2026-05-07T03:36:34.530Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=meal-planner",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=meal-planner",
        "contentDisposition": "attachment; filename=\"meal-planner-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "meal-planner"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/meal-planner"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/meal-planner",
    "downloadUrl": "https://openagent3.xyz/downloads/meal-planner",
    "agentUrl": "https://openagent3.xyz/skills/meal-planner/agent",
    "manifestUrl": "https://openagent3.xyz/skills/meal-planner/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/meal-planner/agent.md"
  }
}
```
## Documentation

### Setup

On first use, read setup.md for onboarding guidelines. Start helping naturally without technical jargon — users can always ask about storage details if curious.

### When to Use

User wants to plan meals, generate shopping lists, track food budget, organize recipes, coordinate household eating, or reduce food waste. Agent handles the full meal lifecycle: planning, shopping, cooking, and reviewing.

### Architecture

Memory lives in ~/meal-planner/. See memory-template.md for structure.

~/meal-planner/
├── memory.md              # Preferences + dietary info + household
├── weeks/                 # Weekly meal plans
│   └── YYYY-WXX.md        # Week 12 of 2026 = 2026-W12.md
├── recipes/               # Saved recipes
│   └── {recipe-name}.md
├── shopping/              # Shopping lists
│   └── YYYY-MM-DD.md
├── inventory/             # What's in pantry/fridge
│   ├── pantry.md
│   └── fridge.md
├── templates/             # Reusable meal templates
│   └── {template-name}.md
└── archive/               # Past weeks for reference

### Quick Reference

TopicFileSetup processsetup.mdMemory templatememory-template.mdShopping optimizationshopping-guide.mdBatch cookingmeal-prep.mdBudget trackingbudget-tips.md

### 1. Check Memory First

Before any meal planning, read ~/meal-planner/memory.md for:

Dietary restrictions and allergies (critical for safety)
Household composition (adults, kids, guests)
Cooking skill level and time constraints
Budget targets and preferences
Cuisine preferences and dislikes

### 2. Meal Planning Lifecycle

PhaseActionPlanCreate week file in weeks/ with all mealsShopGenerate shopping list from week planPrepSuggest batch cooking opportunitiesCookReference recipes, adjust portionsReviewNote what worked, update preferences

### 3. Weekly Planning Rhythm

When user asks to plan meals:

Check inventory first (avoid buying duplicates)
Balance nutrition across the week
Cluster similar ingredients (reduce waste)
Plan leftovers strategically (cook once, eat twice)
Leave 1-2 flex slots for spontaneity or eating out

### 4. Shopping List Generation

For each shopping trip:

## Shopping List — YYYY-MM-DD

### Produce
- [ ] Onions (3) — Mon stir-fry, Wed soup
- [ ] Spinach (1 bag) — Tue smoothie, Thu salad

### Proteins
- [ ] Chicken breast (1.5 lb) — Mon, Wed meals

### Pantry (only if low)
- [ ] Olive oil — check inventory first

**Budget estimate:** $XX
**Store suggestions:** [based on preferences]

Link items to meals so user knows why they're buying each thing.

### 5. Dietary Safety

For any dietary restrictions or allergies:

Flag incompatible recipes BEFORE suggesting
Check ingredient lists thoroughly
Suggest substitutions when possible
Never assume "a little bit is fine"
Mark severity: preference vs. intolerance vs. allergy (life-threatening)

### 6. Household Coordination

When cooking for multiple people:

Track individual restrictions per person
Note kid-friendly vs. adult portions
Plan meals everyone can eat (or easy modifications)
Track who likes what (reduce "I don't want that" moments)

### 7. Budget Optimization

StrategyTypical SavingsWhen to ApplySeasonal produce20-40%Always check what's in seasonBatch cooking30% time, 15% costBusy weeksProtein rotation15-25%Alternate expensive/cheap proteinsPantry meals50%+End of budget cycleStore brands10-30%Most staples

### Weekly Plan Format

# Week YYYY-WXX

## Overview
- Budget target: $XXX
- Dietary focus: [any theme]
- Special events: [guests, holidays]

## Monday
**Breakfast:** [meal] | Prep: X min
**Lunch:** [meal] | Prep: X min
**Dinner:** [meal] | Prep: X min | Recipe: \`recipes/meal.md\`

## Tuesday
...

## Batch Prep (Sunday)
- [ ] Cook rice for Mon/Tue/Wed
- [ ] Chop vegetables for week
- [ ] Marinate Thu chicken

## Shopping Needed
[Auto-generated from meals above]

### Recipe Format

# {Recipe Name}

**Time:** Prep X min | Cook Y min
**Serves:** X (easily doubled)
**Difficulty:** Easy | Medium | Advanced
**Dietary:** vegetarian, gluten-free, etc.

## Ingredients
- X cups ingredient — substitute: [alt]
- Y tbsp ingredient

## Instructions
1. Step one
2. Step two

## Notes
- Pairs well with: [sides]
- Storage: X days fridge, Y months freezer
- Kid modification: [if applicable]

## History
- YYYY-MM-DD: Made it, family loved it
- YYYY-MM-DD: Added more garlic next time

### Inventory Management

Proactively ask about inventory updates:

After shopping trips: "Want to update what you bought?"
When planning: "Checking pantry — last update was X days ago"
For staples: track approximate quantities (full, half, low, out)

## Pantry — Updated YYYY-MM-DD

### Grains & Pasta
| Item | Status | Notes |
|------|--------|-------|
| Rice | Full | 5 lb bag |
| Pasta | Half | |

### Canned Goods
...

### Spices
...

### Common Traps

Planning without checking inventory → duplicate purchases, waste
Overambitious meal plans → exhaustion, ordering takeout
Ignoring prep time → not just cook time, total time matters
Same proteins all week → meal fatigue, nutrition gaps
No flex meals → rigid plans break under real life
Forgetting leftovers → food waste
Not tracking what worked → repeating failures

### Security & Privacy

Data that stays local:

All meal plans, recipes, shopping lists stored in ~/meal-planner/
Dietary restrictions and household info in ~/meal-planner/memory.md
No cloud sync, no external services

This skill does NOT:

Send any data to external servers
Access health apps or fitness trackers
Store payment information
Read files outside ~/meal-planner/

User consent:

Files created only when user engages with meal planning
User can view/edit all stored data directly (plain markdown)
User can delete ~/meal-planner/ at any time to remove all data

### Scope

This skill ONLY:

Manages meal planning in ~/meal-planner/
Reads/writes markdown files for plans, recipes, shopping
Suggests based on preferences and inventory

This skill NEVER:

Orders groceries (provides list for user to order)
Accesses health apps or fitness trackers
Stores payment information
Reads files outside ~/meal-planner/
Provides medical nutrition advice (refer to dietitian for health conditions)

### Related Skills

Install with clawhub install <slug> if user confirms:

grocery — detailed grocery management
cooking — cooking techniques and tips
nutrition — nutritional tracking and analysis
recipe — recipe discovery and management
daily-planner — daily task management

### Feedback

If useful: clawhub star meal-planner
Stay updated: clawhub sync
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: ivangdavila
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T03:36:34.530Z
- Expires at: 2026-05-07T03:36:34.530Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/meal-planner)
- [Send to Agent page](https://openagent3.xyz/skills/meal-planner/agent)
- [JSON manifest](https://openagent3.xyz/skills/meal-planner/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/meal-planner/agent.md)
- [Download page](https://openagent3.xyz/downloads/meal-planner)