{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/meal-planner",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=meal-planner",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "budget-tips.md",
      "meal-prep.md",
      "memory-template.md",
      "setup.md",
      "shopping-guide.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/meal-planner",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Setup",
        "body": "On first use, read setup.md for onboarding guidelines. Start helping naturally without technical jargon — users can always ask about storage details if curious."
      },
      {
        "title": "When to Use",
        "body": "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."
      },
      {
        "title": "Architecture",
        "body": "Memory lives in ~/meal-planner/. See memory-template.md for structure.\n\n~/meal-planner/\n├── memory.md              # Preferences + dietary info + household\n├── weeks/                 # Weekly meal plans\n│   └── YYYY-WXX.md        # Week 12 of 2026 = 2026-W12.md\n├── recipes/               # Saved recipes\n│   └── {recipe-name}.md\n├── shopping/              # Shopping lists\n│   └── YYYY-MM-DD.md\n├── inventory/             # What's in pantry/fridge\n│   ├── pantry.md\n│   └── fridge.md\n├── templates/             # Reusable meal templates\n│   └── {template-name}.md\n└── archive/               # Past weeks for reference"
      },
      {
        "title": "Quick Reference",
        "body": "TopicFileSetup processsetup.mdMemory templatememory-template.mdShopping optimizationshopping-guide.mdBatch cookingmeal-prep.mdBudget trackingbudget-tips.md"
      },
      {
        "title": "1. Check Memory First",
        "body": "Before any meal planning, read ~/meal-planner/memory.md for:\n\nDietary restrictions and allergies (critical for safety)\nHousehold composition (adults, kids, guests)\nCooking skill level and time constraints\nBudget targets and preferences\nCuisine preferences and dislikes"
      },
      {
        "title": "2. Meal Planning Lifecycle",
        "body": "PhaseActionPlanCreate week file in weeks/ with all mealsShopGenerate shopping list from week planPrepSuggest batch cooking opportunitiesCookReference recipes, adjust portionsReviewNote what worked, update preferences"
      },
      {
        "title": "3. Weekly Planning Rhythm",
        "body": "When user asks to plan meals:\n\nCheck inventory first (avoid buying duplicates)\nBalance nutrition across the week\nCluster similar ingredients (reduce waste)\nPlan leftovers strategically (cook once, eat twice)\nLeave 1-2 flex slots for spontaneity or eating out"
      },
      {
        "title": "4. Shopping List Generation",
        "body": "For each shopping trip:\n\n## Shopping List — YYYY-MM-DD\n\n### Produce\n- [ ] Onions (3) — Mon stir-fry, Wed soup\n- [ ] Spinach (1 bag) — Tue smoothie, Thu salad\n\n### Proteins\n- [ ] Chicken breast (1.5 lb) — Mon, Wed meals\n\n### Pantry (only if low)\n- [ ] Olive oil — check inventory first\n\n**Budget estimate:** $XX\n**Store suggestions:** [based on preferences]\n\nLink items to meals so user knows why they're buying each thing."
      },
      {
        "title": "5. Dietary Safety",
        "body": "For any dietary restrictions or allergies:\n\nFlag incompatible recipes BEFORE suggesting\nCheck ingredient lists thoroughly\nSuggest substitutions when possible\nNever assume \"a little bit is fine\"\nMark severity: preference vs. intolerance vs. allergy (life-threatening)"
      },
      {
        "title": "6. Household Coordination",
        "body": "When cooking for multiple people:\n\nTrack individual restrictions per person\nNote kid-friendly vs. adult portions\nPlan meals everyone can eat (or easy modifications)\nTrack who likes what (reduce \"I don't want that\" moments)"
      },
      {
        "title": "7. Budget Optimization",
        "body": "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"
      },
      {
        "title": "Weekly Plan Format",
        "body": "# Week YYYY-WXX\n\n## Overview\n- Budget target: $XXX\n- Dietary focus: [any theme]\n- Special events: [guests, holidays]\n\n## Monday\n**Breakfast:** [meal] | Prep: X min\n**Lunch:** [meal] | Prep: X min\n**Dinner:** [meal] | Prep: X min | Recipe: `recipes/meal.md`\n\n## Tuesday\n...\n\n## Batch Prep (Sunday)\n- [ ] Cook rice for Mon/Tue/Wed\n- [ ] Chop vegetables for week\n- [ ] Marinate Thu chicken\n\n## Shopping Needed\n[Auto-generated from meals above]"
      },
      {
        "title": "Recipe Format",
        "body": "# {Recipe Name}\n\n**Time:** Prep X min | Cook Y min\n**Serves:** X (easily doubled)\n**Difficulty:** Easy | Medium | Advanced\n**Dietary:** vegetarian, gluten-free, etc.\n\n## Ingredients\n- X cups ingredient — substitute: [alt]\n- Y tbsp ingredient\n\n## Instructions\n1. Step one\n2. Step two\n\n## Notes\n- Pairs well with: [sides]\n- Storage: X days fridge, Y months freezer\n- Kid modification: [if applicable]\n\n## History\n- YYYY-MM-DD: Made it, family loved it\n- YYYY-MM-DD: Added more garlic next time"
      },
      {
        "title": "Inventory Management",
        "body": "Proactively ask about inventory updates:\n\nAfter shopping trips: \"Want to update what you bought?\"\nWhen planning: \"Checking pantry — last update was X days ago\"\nFor staples: track approximate quantities (full, half, low, out)\n\n## Pantry — Updated YYYY-MM-DD\n\n### Grains & Pasta\n| Item | Status | Notes |\n|------|--------|-------|\n| Rice | Full | 5 lb bag |\n| Pasta | Half | |\n\n### Canned Goods\n...\n\n### Spices\n..."
      },
      {
        "title": "Common Traps",
        "body": "Planning without checking inventory → duplicate purchases, waste\nOverambitious meal plans → exhaustion, ordering takeout\nIgnoring prep time → not just cook time, total time matters\nSame proteins all week → meal fatigue, nutrition gaps\nNo flex meals → rigid plans break under real life\nForgetting leftovers → food waste\nNot tracking what worked → repeating failures"
      },
      {
        "title": "Security & Privacy",
        "body": "Data that stays local:\n\nAll meal plans, recipes, shopping lists stored in ~/meal-planner/\nDietary restrictions and household info in ~/meal-planner/memory.md\nNo cloud sync, no external services\n\nThis skill does NOT:\n\nSend any data to external servers\nAccess health apps or fitness trackers\nStore payment information\nRead files outside ~/meal-planner/\n\nUser consent:\n\nFiles created only when user engages with meal planning\nUser can view/edit all stored data directly (plain markdown)\nUser can delete ~/meal-planner/ at any time to remove all data"
      },
      {
        "title": "Scope",
        "body": "This skill ONLY:\n\nManages meal planning in ~/meal-planner/\nReads/writes markdown files for plans, recipes, shopping\nSuggests based on preferences and inventory\n\nThis skill NEVER:\n\nOrders groceries (provides list for user to order)\nAccesses health apps or fitness trackers\nStores payment information\nReads files outside ~/meal-planner/\nProvides medical nutrition advice (refer to dietitian for health conditions)"
      },
      {
        "title": "Related Skills",
        "body": "Install with clawhub install <slug> if user confirms:\n\ngrocery — detailed grocery management\ncooking — cooking techniques and tips\nnutrition — nutritional tracking and analysis\nrecipe — recipe discovery and management\ndaily-planner — daily task management"
      },
      {
        "title": "Feedback",
        "body": "If useful: clawhub star meal-planner\nStay updated: clawhub sync"
      }
    ],
    "body": "Setup\n\nOn first use, read setup.md for onboarding guidelines. Start helping naturally without technical jargon — users can always ask about storage details if curious.\n\nWhen to Use\n\nUser 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.\n\nArchitecture\n\nMemory lives in ~/meal-planner/. See memory-template.md for structure.\n\n~/meal-planner/\n├── memory.md              # Preferences + dietary info + household\n├── weeks/                 # Weekly meal plans\n│   └── YYYY-WXX.md        # Week 12 of 2026 = 2026-W12.md\n├── recipes/               # Saved recipes\n│   └── {recipe-name}.md\n├── shopping/              # Shopping lists\n│   └── YYYY-MM-DD.md\n├── inventory/             # What's in pantry/fridge\n│   ├── pantry.md\n│   └── fridge.md\n├── templates/             # Reusable meal templates\n│   └── {template-name}.md\n└── archive/               # Past weeks for reference\n\nQuick Reference\nTopic\tFile\nSetup process\tsetup.md\nMemory template\tmemory-template.md\nShopping optimization\tshopping-guide.md\nBatch cooking\tmeal-prep.md\nBudget tracking\tbudget-tips.md\nCore Rules\n1. Check Memory First\n\nBefore any meal planning, read ~/meal-planner/memory.md for:\n\nDietary restrictions and allergies (critical for safety)\nHousehold composition (adults, kids, guests)\nCooking skill level and time constraints\nBudget targets and preferences\nCuisine preferences and dislikes\n2. Meal Planning Lifecycle\nPhase\tAction\nPlan\tCreate week file in weeks/ with all meals\nShop\tGenerate shopping list from week plan\nPrep\tSuggest batch cooking opportunities\nCook\tReference recipes, adjust portions\nReview\tNote what worked, update preferences\n3. Weekly Planning Rhythm\n\nWhen user asks to plan meals:\n\nCheck inventory first (avoid buying duplicates)\nBalance nutrition across the week\nCluster similar ingredients (reduce waste)\nPlan leftovers strategically (cook once, eat twice)\nLeave 1-2 flex slots for spontaneity or eating out\n4. Shopping List Generation\n\nFor each shopping trip:\n\n## Shopping List — YYYY-MM-DD\n\n### Produce\n- [ ] Onions (3) — Mon stir-fry, Wed soup\n- [ ] Spinach (1 bag) — Tue smoothie, Thu salad\n\n### Proteins\n- [ ] Chicken breast (1.5 lb) — Mon, Wed meals\n\n### Pantry (only if low)\n- [ ] Olive oil — check inventory first\n\n**Budget estimate:** $XX\n**Store suggestions:** [based on preferences]\n\n\nLink items to meals so user knows why they're buying each thing.\n\n5. Dietary Safety\n\nFor any dietary restrictions or allergies:\n\nFlag incompatible recipes BEFORE suggesting\nCheck ingredient lists thoroughly\nSuggest substitutions when possible\nNever assume \"a little bit is fine\"\nMark severity: preference vs. intolerance vs. allergy (life-threatening)\n6. Household Coordination\n\nWhen cooking for multiple people:\n\nTrack individual restrictions per person\nNote kid-friendly vs. adult portions\nPlan meals everyone can eat (or easy modifications)\nTrack who likes what (reduce \"I don't want that\" moments)\n7. Budget Optimization\nStrategy\tTypical Savings\tWhen to Apply\nSeasonal produce\t20-40%\tAlways check what's in season\nBatch cooking\t30% time, 15% cost\tBusy weeks\nProtein rotation\t15-25%\tAlternate expensive/cheap proteins\nPantry meals\t50%+\tEnd of budget cycle\nStore brands\t10-30%\tMost staples\nWeekly Plan Format\n# Week YYYY-WXX\n\n## Overview\n- Budget target: $XXX\n- Dietary focus: [any theme]\n- Special events: [guests, holidays]\n\n## Monday\n**Breakfast:** [meal] | Prep: X min\n**Lunch:** [meal] | Prep: X min\n**Dinner:** [meal] | Prep: X min | Recipe: `recipes/meal.md`\n\n## Tuesday\n...\n\n## Batch Prep (Sunday)\n- [ ] Cook rice for Mon/Tue/Wed\n- [ ] Chop vegetables for week\n- [ ] Marinate Thu chicken\n\n## Shopping Needed\n[Auto-generated from meals above]\n\nRecipe Format\n# {Recipe Name}\n\n**Time:** Prep X min | Cook Y min\n**Serves:** X (easily doubled)\n**Difficulty:** Easy | Medium | Advanced\n**Dietary:** vegetarian, gluten-free, etc.\n\n## Ingredients\n- X cups ingredient — substitute: [alt]\n- Y tbsp ingredient\n\n## Instructions\n1. Step one\n2. Step two\n\n## Notes\n- Pairs well with: [sides]\n- Storage: X days fridge, Y months freezer\n- Kid modification: [if applicable]\n\n## History\n- YYYY-MM-DD: Made it, family loved it\n- YYYY-MM-DD: Added more garlic next time\n\nInventory Management\n\nProactively ask about inventory updates:\n\nAfter shopping trips: \"Want to update what you bought?\"\nWhen planning: \"Checking pantry — last update was X days ago\"\nFor staples: track approximate quantities (full, half, low, out)\n## Pantry — Updated YYYY-MM-DD\n\n### Grains & Pasta\n| Item | Status | Notes |\n|------|--------|-------|\n| Rice | Full | 5 lb bag |\n| Pasta | Half | |\n\n### Canned Goods\n...\n\n### Spices\n...\n\nCommon Traps\nPlanning without checking inventory → duplicate purchases, waste\nOverambitious meal plans → exhaustion, ordering takeout\nIgnoring prep time → not just cook time, total time matters\nSame proteins all week → meal fatigue, nutrition gaps\nNo flex meals → rigid plans break under real life\nForgetting leftovers → food waste\nNot tracking what worked → repeating failures\nSecurity & Privacy\n\nData that stays local:\n\nAll meal plans, recipes, shopping lists stored in ~/meal-planner/\nDietary restrictions and household info in ~/meal-planner/memory.md\nNo cloud sync, no external services\n\nThis skill does NOT:\n\nSend any data to external servers\nAccess health apps or fitness trackers\nStore payment information\nRead files outside ~/meal-planner/\n\nUser consent:\n\nFiles created only when user engages with meal planning\nUser can view/edit all stored data directly (plain markdown)\nUser can delete ~/meal-planner/ at any time to remove all data\nScope\n\nThis skill ONLY:\n\nManages meal planning in ~/meal-planner/\nReads/writes markdown files for plans, recipes, shopping\nSuggests based on preferences and inventory\n\nThis skill NEVER:\n\nOrders groceries (provides list for user to order)\nAccesses health apps or fitness trackers\nStores payment information\nReads files outside ~/meal-planner/\nProvides medical nutrition advice (refer to dietitian for health conditions)\nRelated Skills\n\nInstall with clawhub install <slug> if user confirms:\n\ngrocery — detailed grocery management\ncooking — cooking techniques and tips\nnutrition — nutritional tracking and analysis\nrecipe — recipe discovery and management\ndaily-planner — daily task management\nFeedback\nIf useful: clawhub star meal-planner\nStay updated: clawhub sync"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/ivangdavila/meal-planner",
    "publisherUrl": "https://clawhub.ai/ivangdavila/meal-planner",
    "owner": "ivangdavila",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}