Hydration Coach — AI skill for Claude Code

hydration-coach — one water reminder for every AI coding tool

A hydration reminder skill that works in **all mainstream AI coding tools** — Claude Code, Codex, Cursor, Gemini CLI, WorkBuddy, and anything else that reads [Agent Skills](https://agentskills.io). The format is a standard, so only the *discovery path* differs between tools. This repo solves that with one trick: **a single canonical directory, symlinked into every tool's skills root.**

~/.agents/skills/hydration-coach      ─┐
~/.claude/skills/hydration-coach       │
~/.codex/skills/hydration-coach        │
~/.cursor/skills/hydration-coach       ├─→ one directory, linked everywhere
~/.gemini/skills/hydration-coach       │
~/.workbuddy/skills/hydration-coach    │
~/.config/opencode/skills/hydration-coach ─┘

Edit once, every tool follows.

How the reminder actually reaches you

A skill is instructions; Agent Skills **cannot run a background daemon** — that is the standard's boundary, not a shortcut here. So delivery has four layers, and any one of them is enough:

Layer	Fires when	Covers	Reliability
Hook (recommended)	you submit any prompt / start a session	Claude Code, Codex, Cursor, Gemini CLI	high — genuinely automatic
In-session instruction	the agent runs check because the skill says to	every tool	medium — depends on the model
Manual	you run npm run status / check	every tool	certain
OS scheduler	launchd / cron / Task Scheduler	independent of any agent	highest — no tool needed

With hooks installed you get the **native OS notification** at the due time, plus — on Claude Code — one short line from the agent in the conversation.

Install

node scripts/install.mjs --dry-run     # see exactly what would change, write nothing
node scripts/install.mjs --hooks       # link the skill + wire the automatic reminder

Optional:

node scripts/install.mjs --project ~/my-repo   # also