Vitamin Tracker Channel

Manage vitamin/supplement reminders across configurable daily time slots via cron jobs. Use when adjusting supplement schedules, adding/removing supplements,...

Security Scan

The skill's code, instructions, and required environment variables are consistent with its stated purpose of creating and managing vitamin reminder cron jobs.

Purpose & Capability

Name and description match the delivered Python script and SKILL.md: the script parses VITAMINS.md, and uses the openclaw CLI to remove and recreate cron jobs that post reminders to a specified channel. Required runtime tools (python3 and openclaw CLI) are appropriate for this task.

Instruction Scope

Instructions stay within scope: they read $WORKSPACE/VITAMINS.md, list/remove/create cron jobs via the openclaw cron CLI, and format reminder messages. Caution: the script unconditionally removes any existing jobs named vitamins-*-reminder before recreating them, which can delete other jobs that share that naming convention; SKILL.md does mention backing up existing jobs, but users should verify there are no naming collisions.

Install Mechanism

No install spec (instruction-only plus included script). Nothing is downloaded or written by an installer. The script will run locally and requires the existing 'openclaw' CLI and python3, which the SKILL.md documents.

Credentials

Declared env vars (VITAMIN_CHANNEL_ID, VITAMIN_TIMEZONE, optional WORKSPACE) are appropriate. The script constructs an internal session key string ('agent:main:discord:channel:{channel_id}') and passes it to the openclaw cron command; this appears to be how the platform binds cron jobs to a delivery session. No unrelated credentials or secrets are requested.

Persistence & Privilege

The skill creates persistent cron jobs (managed by openclaw) that will deliver messages over the network when they run — this is expected for a reminder tool. always:false and no special platform-wide configuration changes are requested. Users should be aware cron jobs persist until removed.

Assessment

This skill appears to do exactly what it says: parse a workspace VITAMINS.md and create cron-delivered reminders in the specified channel. Before installing or running it: 1) ensure the openclaw CLI is trusted on your system (it performs the job creation/removal); 2) back up existing cron jobs (or verify none use the vitamins-*-reminder name) because the script removes any jobs with that naming pattern; 3) set VITAMIN_CHANNEL_ID and VITAMIN_TIMEZONE correctly and confirm VITAMINS.md contains only non-sensitive info; 4) run the script manually first to review the created job JSON output (the script prints job creation status) so you can confirm behavior before letting cron deliver messages autonomously.

Manage supplement reminders across configurable daily time slots using OpenClaw cron jobs.

Configuration

Set the following environment variables:

• VITAMIN_CHANNEL_ID — the channel to post reminders in
• VITAMIN_TIMEZONE — IANA timezone for scheduling (e.g. America/New_York, Europe/Berlin)
• WORKSPACE — root workspace directory (defaults to ~/.openclaw/workspace)

Supplement names and schedules are configured in VITAMINS.md in the workspace root. Edit the schedule section to match your regimen.

Schedule Format

VITAMINS.md should have a ## Schedule section with time labels and HH:MM times, followed by ### Label subsections listing supplements:

## Schedule

- Breakfast: 09:00
- Lunch: 13:00
- Dinner: 18:00

### Breakfast

- Multivitamin
- Vitamin C
- Vitamin D₃

### Lunch

- Fiber (keep 2h away from minerals)

### Dinner

- Magnesium

Update Script

After editing VITAMINS.md, run the update script to sync all cron jobs:

python3 scripts/update_vitamin_crons.py

This reads VITAMINS.md, removes existing vitamin cron jobs, and recreates them with the updated schedule.

What the Script Handles

• Parses the ## Schedule section for times
• Parses each ### Label section for supplement lists
• Creates one cron job per time slot (up to 5 configurable slots)
• Formats reminder messages: "Vitamin reminder: Breakfast time. Take Multivitamin, Vitamin C, and Vitamin D₃."
• Removes old jobs before recreating to avoid duplicates

Cron Job Naming

Jobs are named vitamins-{label}-reminder (e.g. vitamins-breakfast-reminder, vitamins-lunch-reminder).

Runtime Requirements

• python3 — the update script is Python
• openclaw CLI — the script calls openclaw cron to manage jobs

Data Access

This skill:

• Reads $WORKSPACE/VITAMINS.md — your supplement schedule (user-created)
• Manages cron jobs via the openclaw cron CLI — removes existing vitamin jobs, then recreates them
• Posts messages to the configured channel via cron delivery (requires network when cron fires)
• No data files written — schedule lives in VITAMINS.md, state is in the cron system

Note: The update script removes all existing vitamins-*-reminder cron jobs before recreating them. Back up existing jobs if needed.

Required Files

• scripts/update_vitamin_crons.py — cron job sync script (included in bundle)
• $WORKSPACE/VITAMINS.md — supplement schedule (user-created, not included)