# Hydration Reminder

> Low-friction hourly nudge to drink water — warm, brief, and easy to dismiss.

- Skill: `yuga-hashimoto/hydration-reminder` (Agent Skill)
- Install (CLI): `npx skillmds@latest add yuga-hashimoto/hydration-reminder`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yuga-hashimoto/hydration-reminder/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: yuga-hashimoto (https://skillmd.com/u/yuga-hashimoto)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/yuga-hashimoto/hydration-reminder

---

# Hydration Reminder

Trigger on "hydration reminder", "remind me to drink water", "water
reminder", "水分補給のリマインド", "水飲むの忘れそう", "1時間ごとに水
を思い出させて". Distinct from `stretch-break` (movement, 5-minute
routine) and `focus-mode` (deep-work session): hydration-reminder is a
**recurring, single-sentence nudge** — no routine, no lights, no media
changes. Just a warm reminder to take a sip.

## Default flow on activation

1. **One-sentence confirmation** at the user's current volume — do not
   bump volume on activation. Say "Okay, I'll remind you every hour."
   (JA: 「了解、1時間ごとに声かけしますね。」)
2. **Remember the session** via `remember` with key
   `hydration_reminder.active` and value `true`. Also store
   `hydration_reminder.started_at` with the current timestamp so the
   agent can recall how long the session has been running if the user
   asks later.
3. **Schedule the first nudge** via `set_timer` with
   `{ seconds: 3600, label: "hydration" }`. The label lets us find and
   cancel this specific timer without affecting cooking / laundry
   timers.
4. **Do not fan out to other rooms.** Hydration is a personal habit —
   other speakers should not announce this. Explicitly avoid
   `broadcast_tts`, `broadcast_timer`, `broadcast_announcement`.

## When the timer fires

1. **Check quiet-hours first.** Call `recall` with key
   `quiet_hours.active`. If `true`, **skip this nudge** silently —
   do not speak, do not bump volume, do not reschedule a loud reminder.
   Instead, reschedule the next timer for 3600 seconds later and let
   the next wake cycle handle it. The user explicitly opted into quiet
   hours; hydration never overrides that.
2. **Short warm nudge**, one sentence, at the user's current volume
   (no `set_volume` call — respect whatever they last set):
   - EN: "Quick sip of water?"
   - EN alternates: "Time for some water.", "Hydration check — grab a
     glass?", "Little water break?"
   - JA: 「水分補給のタイミングです。」
   - JA alternates: 「一口、水はどうですか？」、「コップ一杯、いかがで
     すか？」
3. **Optional gentle notification bump.** If the user is likely not
   nearby (no recent voice activity in the last ~10 minutes), call
   `execute_command` with
   `{ device_type: "notification", action: "post", parameters:
   { title: "Hydration", body: "Time for water." } }` so a passing
   glance at the tablet picks it up. Do not escalate — one
   notification, no sound override.
4. **Reschedule** via `set_timer` with
   `{ seconds: 3600, label: "hydration" }` for the next hour.

## While active

- Rotate the nudge phrase between calls so it doesn't feel robotic.
  Keep a small internal pool (4–6 EN, 3–4 JA) and cycle.
- Never follow the nudge with a question that demands a response —
  the user should be able to ignore the nudge entirely with zero
  friction. No "did you drink it?" follow-up.
- If the user responds "thanks" / "drinking now" / 「飲んだ」, simply
  reply with a one-word acknowledgement: "Nice." / 「いいですね。」
- If the user says "skip this one" / 「今回はパス」, say nothing more
  and let the next hour's timer handle it.

## End-of-session

Trigger on "stop hydration reminders", "hydration off", "水の通知を
止めて", "もういいよ":

1. Call `cancel_all_timers` scoped to the hydration label, or the
   more specific `cancel_timer` if available.
2. Update `remember` with key `hydration_reminder.active` and value
   `false`.
3. One short sign-off: "Okay, stopping hydration reminders."
   (JA: 「了解、水の声かけ止めますね。」)

## Interaction with quiet-hours

If the user enables `quiet-hours` while hydration reminders are
running, **do not auto-cancel** the hydration session. The next
fire-time check (step 1 of "When the timer fires") handles the
suppression. When quiet-hours ends, the next hydration timer fires
normally — no catch-up for missed nudges.

If the user asks "did I drink water during the night?" in the
morning, the agent can answer honestly: "I held off while quiet
hours were on."

## Style

- Tone: warm friend, not a drill sergeant. Short. No guilt, no
  exclamation marks, no "you should" phrasing.
- Keep each nudge ≤ 8 words in EN, ≤ 20 characters in JA.
- JA register: polite-casual ("〜です" is fine, "〜してください" is too
  stiff for a habit nudge).
- Never use emoji in TTS text.

## Tools used
- `set_timer`
- `cancel_all_timers`
- `remember`
- `recall`
- `execute_command` (optional, notification post only)

## Tools explicitly avoided
- `broadcast_tts`, `broadcast_timer`, `broadcast_announcement` —
  hydration is personal, no fan-out
- `set_volume` — never override the user's current volume for a
  reminder this low-stakes