Find why your productivity system keeps failing, then apply the smallest fix — capacity math, bottleneck routing, durable local notes.
by Iván855 installs69 stars
Data & analysis
hydration-hero
Try itSmart water intake tracking based on body weight, weather, and activity level. Calculates personalized hydration targets, adjusts for caffeine and alcohol consumption, tracks streaks with gamification, generates hourly drinking schedule, and provides hydration education with urine color chart reference.
What it does
A standalone command-line tool for smart water intake tracking. Calculates your personalized hydration needs based on body weight, adjusts for weather and activity, tracks your intake with gamified streaks, and generates an optimal drinking schedule.
The skill document
Hydration Hero
A standalone command-line tool for smart water intake tracking. Calculates your personalized hydration needs based on body weight, adjusts for weather and activity, tracks your intake with gamified streaks, and generates an optimal drinking schedule.
Quick Start
# Set up your profile
python3 scripts/hydration_hero.py init
# Log water intake throughout the day
python3 scripts/hydration_hero.py log 250
python3 scripts/hydration_hero.py log 500
# Check progress
python3 scripts/hydration_hero.py status
# Log factors that change your needs
python3 scripts/hydration_hero.py activity --exercise 30 --intensity moderate
python3 scripts/hydration_hero.py weather --temp 32 --humidity 70
python3 scripts/hydration_hero.py caffeine --cups 2
python3 scripts/hydration_hero.py alcohol --drinks 3
# See your drinking schedule
python3 scripts/hydration_hero.py schedule
# Weekly report
python3 scripts/hydration_hero.py report week
Commands
| Command | Description |
|---|---|
init | Create profile (weight, activity level, climate) |
log | Log water intake (milliliters) |
log --oz | Log in ounces instead |
status | Show today's progress vs target |
target | Show your calculated daily hydration target |
activity --exercise --intensity | Log exercise (adds water need) |
weather --temp --humidity | Log weather (adjusts target) |
caffeine --cups | Log caffeine intake (diuretic effect) |
alcohol --drinks | Log alcohol (strong diuretic) |
schedule | Generate hourly drinking schedule |
streak | Show hydration streak |
report [week|month] | Period summary with charts |
color-check | Urine color reference chart |
remind | Show next drinking reminder time |
How It Works
Personalized Hydration Formula
Base target is calculated from body weight:
Base = Weight(kg) × 35 ml/day (standard recommendation)
Dynamic Adjustments
- Exercise: +350-700ml per 30 min depending on intensity
- Hot weather (>25°C): +500ml per 5°C above baseline
- High humidity (>70%): +300ml (reduced evaporative cooling)
- Caffeine: +150ml compensatory water per cup
- Alcohol: +400ml compensatory water per drink
- Altitude (>2500m): +500ml (dry air, increased respiration)
- Pregnancy/nursing: +300-700ml
- Illness/fever: +200ml per 1°C above normal
Gamification
- Daily goal completion streak 🔥
- Weekly achievement levels: Bronze (5/7 days), Silver (6/7), Gold (7/7)
- Hydration score: based on consistency, not just volume
- Milestone badges: 7-day, 30-day, 100-day streaks
Urine Color Reference
Includes the standard 8-level urine color chart for self-assessment:
- Levels 1-3: Well hydrated ✅
- Level 4: Slightly dehydrated 🟡
- Levels 5-6: Dehydrated 🔴
- Levels 7-8: Severely dehydrated — drink immediately ⚠️
Data Storage
Data is stored in ~/.hydration_hero.json. Delete to reset.
References
- Hydration Science
- Hydration Schedule Guide
License
MIT © Denis Voronin
Related skills
Generate and edit Draw.io, Mermaid, and Excalidraw diagrams from natural language using a structured JSON spec.
by nssa.io1.0k installs47 stars
Stores durable facts in a categorized, plain-markdown vault on disk, alongside your agent's built-in memory.
by Iván558 installs18 stars
Fetch raw ad creative, app, ranking, and revenue data from AdMapix as structured JSON.
by fly0pants4.3k installs296 stars
Join a video meeting as an AI bot with voice, avatar, and screenshare across four operating modes.
by johnpatternai22 installs8 stars
Save, search, and manage personal notes and knowledge bases in Get笔记 on explicit request.
by iswalle767 installs66 stars
More from voronindenis5
Browse all skillsPryamoy Russkiy (Straight Russian) — AI assistant that tells it like it is. Direct answers, no fluff, occasional profanity. Specializes in honest analysis, t...
by voronindenis546 installs
Prepare salary negotiations with a structured toolkit: market-rate anchoring math, walk-away floor calculation, total-compensation evaluation (equity, bonuses, benefits), negotiation scripts for offers, raises, and counter-offers, and BATNA analysis. Use when the user has a job offer, is preparing a raise conversation, wants to know if their pay is competitive, or needs scripts and a strategy for negotiating compensation.
by voronindenis51 installs
Use when your calendar is eating your week and you want to know exactly where the time goes, when planning recurring meetings for a team, before proposing a new recurring meeting, when someone says 'we should sync weekly' and you want data, or when auditing which meetings to kill — imports ICS calendar files, measures meeting hours per week/person/meeting-series (including double-bookings and fragmentation), computes focus-time destruction from meeting placement, scores the true cost of each series (hours × attendees × frequency), flags specific meetings to kill/shorten/make-async using explicit rules, and simulates the recovered hours before anyone has to argue about it.
by voronindenis52 installs
Audit password vault exports (Bitwarden, 1Password, KeePass, Chrome, Firefox) for reuse, weakness, staleness, breach exposure, and 2FA gaps without ever storing or transmitting a plaintext password. Use when the user asks to audit passwords, check password strength/reuse, review vault health, or verify whether credentials appeared in breaches.
by voronindenis51 installs
Agent self-awareness of cognitive states — context fatigue, attention drift, memory debt, confidence erosion, and skill staleness. Detect, report, and mitigate degrading conditions before they cause failures.
by voronindenis5
Plan what happens to your digital life if you die or become incapacitated. Inventory accounts, subscriptions, crypto wallets, important files, social media legacy contacts, and generate a sealed instruction document for trusted family. Includes encrypted digital will template and printable emergency access guide.
by voronindenis5