← 返回 Skills 市场

Hydration Tracker

Name: Hydration Tracker
Author: bytesagain1

作者 bytesagain1 · GitHub ↗ · v2.0.1 · MIT-0

cross-platform ✓ 安全检测通过

315

总下载

当前安装

版本数

在 OpenClaw 中安装

/install hydration-tracker

功能描述

Track daily water intake, set hydration goals, and get drink reminders. Use when logging water, setting targets, or reviewing weekly intake trends.

使用说明 (SKILL.md)

Hydration Tracker

A daily water intake tracker that helps you build and maintain healthy hydration habits. Log every drink, set personalized daily goals, check your progress throughout the day, and review weekly summaries — all from the command line with local-only data storage.

Commands

Command	Description
`drink [ml]`	Log water intake in milliliters (default: 250ml). Shows running total and goal progress with celebration when goal is reached
`cup`	Quick-log a cup of water (250ml) — shortcut for `drink 250`
`bottle`	Quick-log a bottle of water (500ml) — shortcut for `drink 500`
`today`	Display today's total intake vs. daily goal, with remaining amount or goal-reached indicator
`goal [ml]`	Set your daily hydration goal in milliliters (default: 2000ml)
`check`	Check if you're on track — compares current intake against expected intake based on time of day
`week`	Show a 7-day hydration summary with daily breakdowns, weekly total, and daily average
`history [n]`	Show hydration history for the last N days (default: 7, max: 30)
`stats`	Display overall statistics — total days tracked, total intake, and average daily intake
`remind`	Get a random hydration tip (e.g., "Drink a glass of water before each meal")
`info`	Show version info (v1.0.0)
`help`	Show all available commands with usage examples

Data Storage

Data directory: ~/.water_reminder/
Intake data: data.json — JSON object mapping dates (YYYY-MM-DD) to cumulative daily intake in ml
Goal config: goal.json — stores your current daily goal (default: 2000ml)
Max history: 30 days of lookback for the history command
All data is stored locally in JSON format; no external services, accounts, or network access required

Requirements

Bash 4+
Python 3 (standard library only — used for JSON read/write)
Standard POSIX utilities (date, seq)
No API keys or external dependencies

When to Use

Building a daily hydration habit — log each drink throughout the day and let the progress tracker keep you motivated with goal-reached celebrations
Checking mid-day progress — use check to see if your intake is on track relative to the time of day, so you can catch up before evening
Reviewing weekly trends — run week to see a 7-day summary with emoji indicators showing which days you hit your goal
Adjusting your hydration goal — use goal to increase or decrease your daily target based on activity level, weather, or health needs
Getting gentle reminders — run remind for evidence-based hydration tips to keep healthy habits top of mind

Examples

# Log 300ml of water
hydration-tracker drink 300

# Quick-log a cup (250ml)
hydration-tracker cup

# Quick-log a bottle (500ml)
hydration-tracker bottle

# Check today's progress
hydration-tracker today

# Set a custom daily goal of 2500ml
hydration-tracker goal 2500

Example Output

$ hydration-tracker drink 300
Logged 300ml. Today's total: 1200ml / 2000ml.
Almost there! Keep going!

$ hydration-tracker today
Today's intake (2026-03-18): 1200ml / 2000ml
Remaining: 800ml

$ hydration-tracker week
--- Weekly Hydration Summary ---
2026-03-18: (1200ml / 2000ml) 💧
2026-03-17: (2100ml / 2000ml) 🎉
2026-03-16: (1800ml / 2000ml) 💧
...
Weekly total: 12300ml
Daily average: 1757ml (Goal: 2000ml)

$ hydration-tracker remind
💧 Hydration Tip: Drink a glass of water before each meal.

安全使用建议

This appears to be a simple, local-only CLI tool. Before installing: (1) verify you have Bash 4+ and Python 3 available (SKILL.md requires them even though registry metadata didn't list binaries), (2) confirm you are comfortable with the skill creating and writing files under ~/.water_reminder (data.json and goal.json), (3) if you run macOS, test or adjust the date commands (date -d may be incompatible), and (4) review the included script if you want to be certain there are no hidden network calls or data exports (the provided script contains none). The skill requests no credentials and does not require network access.

功能分析

Type: OpenClaw Skill Name: hydration-tracker Version: 2.0.1 The Hydration Tracker skill is a legitimate utility for logging water intake with all data stored locally in ~/.water_reminder/. The implementation in scripts/script.sh uses safe practices, such as input validation via regex and passing variables to Python sub-processes through environment variables to prevent shell injection. There are no network calls, obfuscated code, or attempts to access sensitive system files.

能力评估

ℹ Purpose & Capability

The skill's name/description match the included script: it logs drinks, manages a goal, and shows summaries stored under ~/.water_reminder. Minor inconsistency: registry metadata lists no required binaries, but SKILL.md and the script require Bash 4+ and Python 3 (standard library). This is expected for a shell-based CLI but should be declared in registry fields.

✓ Instruction Scope

SKILL.md instructions and the script stay within scope: they read/write local files (data.json, goal.json) and run only local commands. There are no network calls, no reading of unrelated files, and no requests for credentials. Minor portability caveat: the script uses GNU date semantics (date -d), which may not work on some platforms (e.g., stock macOS date) without coreutils.

✓ Install Mechanism

No install spec (instruction-only) and the provided script is included directly. No downloads, package installs, or extracted archives are performed by the skill—low install risk.

✓ Credentials

The skill requests no environment variables, no credentials, and stores data locally. This is proportionate to the claimed functionality.

✓ Persistence & Privilege

always:false and user-invocable:true (defaults). The skill writes only to its own data directory (~/.water_reminder) and does not modify other skills or system-wide settings.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install hydration-tracker
安装完成后，直接呼叫该 Skill 的名称或使用 /hydration-tracker 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v2.0.1

update

v2.0.0

v2.5 standard: Use-when desc, homepage, source, security fix

v1.0.6

yaml-fix+quality

v1.0.5

yaml-fix+quality

v1.0.4

Quality upgrade

v1.0.3

Quality upgrade: custom functionality

v1.0.2

Standards compliance: unique content, no template text

v1.0.1

Quality improvement: better docs, examples, cleaner text

v1.0.0

Initial release

元数据

Slug hydration-tracker

版本 2.0.1

许可证 MIT-0

累计安装 1

当前安装数 1

历史版本数 9

常见问题