nutrition-tracker_skill

Overview

This skill tracks daily calories and macros inside an Obsidian vault and keeps a lightweight nutrition profile for personalized targets. It logs meals, computes daily totals, and evaluates whether intake meets goal-based targets (cut, maintain, bulk). Scripts support English and Simplified Chinese (en-US / zh-CN) for local use.

How this skill works

The skill stores a profile (sex, height, weight, activity, goal, optional explicit macro targets) and appends meal entries to monthly markdown logs in your vault. Daily totals are computed from logged meals and compared to either computed defaults (based on weight and goal) or explicit targets in the profile. All interactions are performed via deterministic shell scripts to initialize profile, log meals, and check today's status.

When to use it

• After you initialize or update your nutrition profile for the current goal
• When you log a meal to record calories and protein/carbs/fat
• To check if today’s intake meets calorie and macro targets
• When you want monthly markdown logs in Obsidian for review or export
• If you prefer deterministic scripts over free-form editing for auditability

Best practices

• Initialize a complete profile (sex, height, weight, activity, goal) before logging meals to enable accurate targets
• Provide explicit macro targets in the profile if you need precise ratios instead of goal-based defaults
• Log meals with approximate macros immediately after eating to reduce recall error
• Keep the vault path and language flags consistent across scripts for predictable storage and display
• Treat meal entries as estimates and update entries later when you obtain better nutrition info

Example use cases

• Initialize a new profile for a fat-loss phase and compute default protein/fat targets
• Log dinner with calories and P/C/F to add to that day’s total markdown file
• Run the daily check script each evening to verify if calorie and macro goals were met
• Review monthly Markdown logs in Obsidian to spot trends and adjust activity or calorie targets
• Override default macro targets in the profile for a tailored nutrition plan