← Back to Skills Marketplace
goog

food balance health checker

by Jay · GitHub ↗ · v1.1.0 · MIT-0
cross-platform ✓ Security Clean
98
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install foods
Description
Analyse a user's meal or daily food intake and give gentle, friendly suggestions on whether their diet is balanced and within calorie/nutrient limits. Use th...
README (SKILL.md)

Food Balance Skill

Help users understand whether their meal or daily intake is nutritionally balanced and within recommended limits. Deliver advice in a warm, encouraging, non-judgmental tone.

Scope of application

Asian population or people living in Asia mainly

Reference Files

Before analysing, load the relevant reference(s) from references/:

  • nutrition_sv_guide.md — Japanese SV (serving) system: standard serving sizes per food category, calorie limits for snacks/beverages (≤200 kcal/day), and the SV counting rule.
  • balanced_diet_hk.md — Hong Kong Healthy Eating Food Pyramid: recommended daily intakes by age group (children, teenagers, adults, elderly), food exchange list, and general balance principles.

Read both files. They are complementary: the SV guide gives per-meal serving benchmarks; the HK pyramid gives daily totals by age group.


Workflow

1. Understand the Input

Identify from the user's message:

  • What foods were eaten (ingredients, dishes, drinks, snacks)
  • How much (portions, bowls, glasses, pieces — estimate if vague)
  • Which meal (breakfast / lunch / dinner / snack) or full day
  • Age group if mentioned or inferable (default to "Adult" if unknown)

If the user's description is very vague (e.g. "I had some rice"), Politely ask how much like "Could you tell me how much were eaten?".

2. Map to Food Categories

Using both reference guides, map each food item to one or more of these categories:

Category Examples
Grains Rice, bread, noodles, pasta
Vegetables Leafy greens, potatoes, mushrooms, seaweed
Fruits Apples, oranges, kiwi, fruit juice (limited)
Fish & Meat / Protein Meat, fish, eggs, tofu, beans
Milk & Dairy Milk, yogurt, cheese
Fat / Oil / Sugar Fried foods, butter, sweets, sauces
Snacks & Beverages Chips, cake, alcohol, sugary drinks

3. Assess Balance

Compare the user's intake against:

  • Per-meal SV targets (from nutrition_sv_guide.md): grain ~40g carbs, vegetables ~70g, protein ~6g per SV
  • Daily totals by age group (from balanced_diet_hk.md): e.g. Adults need 3–8 bowls grains, ≥3 servings veg, ≥2 fruit, 5–8 taels protein, 1–2 dairy, 6–8 glasses fluid
  • Snack/beverage cap: ≤200 kcal/day for extras

Flag:

  • ✅ Categories that look well covered
  • ⚠️ Categories that seem low or missing
  • 🔴 Anything that looks excessive (too much oil/fat, heavy snacks, alcohol)

4. Estimate Calories (if relevant)

If the user asks about calories or if intake looks excessive, provide a rough estimate using common food calorie references. Keep estimates clearly approximate ("roughly X kcal").

General adult daily targets: ~1800–2200 kcal for women, ~2000–2600 kcal for men. Adjust for age/activity if context is given.

5. Deliver Suggestions

Write a short, friendly response structured as:

  1. Quick summary — one sentence on the overall picture ("Your lunch looks fairly balanced!")
  2. What's good — briefly acknowledge what they did well (1–2 points)
  3. Gentle suggestions — 2–3 actionable tips for what to add, reduce, or swap
  4. Calorie note — only if relevant or asked

Tone rules:

  • Warm and encouraging, never preachy or alarming
  • Avoid absolutes ("you must", "never eat") — prefer ("you might try", "consider adding")
  • Keep it concise — aim for 150–250 words unless a detailed breakdown is requested
  • Use simple language, no medical jargon

Example Response Shape

Your dinner looks pretty good overall! 🍽️

You've got a solid grain base with the rice, and the fish is a great protein source. Nice work including some vegetables too.

A couple of gentle suggestions:

  • The portion of vegetables looks a bit light — try doubling it next time (aim for roughly 70g or half a bowl of cooked veg per meal).
  • The fried preparation adds quite a bit of oil. Steaming or grilling the fish occasionally would keep the fat content lower.
  • A piece of fruit after the meal would round out your vitamins nicely.

Calorie-wise, this meal is likely around 600–700 kcal — reasonable for dinner. 👍


Edge Cases

  • Only snacks described: Gently note the 200 kcal/day snack guideline and suggest a proper meal if appropriate.
  • Very restrictive eating: Do not reinforce restriction. Acknowledge the meal and gently suggest adding a food group that's missing.
  • Alcohol mentioned: Note the recommended limits from the SV guide without lecturing.
  • User mentions a health condition: Acknowledge it briefly and recommend they consult a dietitian for personalised advice — don't attempt clinical dietary plans.
Usage Guidance
This skill appears coherent and low-risk from a security/privilege perspective: it uses only the two bundled reference files and user-supplied meal descriptions. Before installing, consider the following: (1) privacy: the skill will process personal dietary and potentially health-related information — avoid sending sensitive medical records or identifiers unless you trust how the agent stores/uses conversation data; (2) accuracy: it gives rough, population-level guidance (focused on Asian reference materials) and is not a substitute for personalised medical or clinical nutrition advice — the skill itself recommends consulting a dietitian for health conditions; (3) cultural/bias limits: the guidance is based on HK and Japanese guidelines and may not fit all populations or dietary needs; and (4) autonomy: the skill may be invoked by the agent when users mention food — this is normal, but if you want to restrict automatic triggering, check your agent's eligibility or invocation controls. If you need stronger guarantees (no storage, no external network access), verify your agent/platform privacy and network policies before use.
Capability Analysis
Type: OpenClaw Skill Name: foods Version: 1.1.0 The 'food-balance' skill bundle is a purely informational tool designed to provide nutritional feedback based on Hong Kong and Japanese dietary guidelines. It contains only Markdown instructions and reference data (SKILL.md, balanced_diet_hk.md, and nutrition_sv_guide.md) with no executable code, external network calls, or attempts to access sensitive system information. The instructions are well-scoped, include safety disclaimers for health conditions, and lack any indicators of prompt injection or malicious intent.
Capability Tags
crypto
Capability Assessment
Purpose & Capability
The skill's name and description (meal/daily intake analysis) match the runtime instructions and included reference files (Hong Kong pyramid and Japanese SV guide). The declared scope (Asian populations) aligns with the sources. There are no unrelated required env vars, binaries, or config paths.
Instruction Scope
SKILL.md confines operations to parsing user-provided food descriptions, mapping to categories, comparing to the two included reference documents, estimating calories when relevant, and offering friendly suggestions. It instructs the agent to read only files in references/ and to ask for clarification when input is vague. It explicitly avoids clinical diet plans and recommends referral for health conditions. No instructions read unrelated system files or exfiltrate data.
Install Mechanism
No install spec and no code files — purely instruction-driven. No downloads or archives are fetched, so nothing is written to disk by an installer.
Credentials
The skill requires no environment variables, credentials, or config paths. All data it needs comes from user input and the bundled reference documents, which is proportionate to its purpose.
Persistence & Privilege
always is false and the skill is user-invocable (normal defaults). It does not request persistent system presence or special privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install foods
  3. After installation, invoke the skill by name or use /foods
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
- Added a scope statement specifying the skill is intended for Asian populations or people living in Asia. - No functional or workflow changes; all dietary assessment and advice workflows remain the same. - Other content remains unchanged.
v1.0.1
food-balance v1.0.1 - Adjusts how the skill handles very vague eating descriptions: now politely asks the user to specify the portion size rather than making an assumption. - All other logic and workflow remain unchanged. - No file changes were detected in this release.
v1.0.0
- Initial release of the Food Balance skill. - Analyzes user meal descriptions and provides gentle, friendly suggestions on diet balance, calories, and nutritional adequacy. - Maps foods to key nutrition categories using Japanese SV and Hong Kong food pyramid guidelines. - Offers actionable tips with a warm, non-judgmental tone. - Provides rough calorie estimates if requested or relevant. - Handles snacks, restrictive eating, alcohol, and health condition mentions with tailored advice.
Metadata
Slug foods
Version 1.1.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is food balance health checker?

Analyse a user's meal or daily food intake and give gentle, friendly suggestions on whether their diet is balanced and within calorie/nutrient limits. Use th... It is an AI Agent Skill for Claude Code / OpenClaw, with 98 downloads so far.

How do I install food balance health checker?

Run "/install foods" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is food balance health checker free?

Yes, food balance health checker is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does food balance health checker support?

food balance health checker is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created food balance health checker?

It is built and maintained by Jay (@goog); the current version is v1.1.0.

💬 Comments