HerCycle
by @gloria-zhang1
Women's cycle intelligence companion. Reads Whoop biometric data (HRV, recovery, sleep, skin temperature) and menstrual cycle phase to understand which hormo...
clawhub install hercycleπ About This Skill
name: hercycle description: Women's cycle intelligence companion. Reads Whoop biometric data (HRV, recovery, sleep, skin temperature) and menstrual cycle phase to understand which hormonal "season" the user is in β and takes smart, phase-aware actions. Use when the user asks about their cycle phase, energy, mood, what to eat, how hard to train, when to schedule important meetings, or wants any Whoop-powered recommendation tailored to their hormonal cycle. NOT a period tracker β a biometric intelligence layer that treats the cycle as a source of power, not a problem.
HerCycle β Women's Cycle Intelligence
Built on the insight that women's biology is cyclical, not linear. Every month has four distinct hormonal seasons β each unlocking different cognitive, emotional, and physical capabilities. HerCycle reads your biometrics and tells you which season you're in, then takes action accordingly.
The Four Seasons
| Season | Phase | Days | What's Amplified | |--------|-------|------|-----------------| | π Winter | Menstrual | 1β5 | Introspection, pattern recognition, deep insight, rest & recovery | | π± Spring | Follicular | 6β14 | Creativity, optimism, new ideas, social energy, starting things | | βοΈ Summer | Ovulation | ~14 | Communication, charisma, negotiation, peak performance, visibility | | π Autumn | Luteal | 15β28 | Detail orientation, completion, editing, boundaries, deep focus |
Data Sources
HerCycle reads from:
cycle_tracking table), or inferred from skin temp patternsSee references/whoop-api.md for data access patterns.
Action Modules
Actions are pluggable. Each module takes the current phase + biometrics and returns a recommendation or triggers an action.
Current modules:
spotify_engine.py or bring your own)To add a new action module: see references/action-modules.md.
Usage
Check current phase: > "What phase am I in?" / "What's my cycle season today?"
Phase-aware recommendation: > "Should I push hard at the gym today?" > "What should I eat this week?" > "Is this a good week for a big presentation?"
Trigger an action: > "Play music for my phase" / "Give me a playlist for my cycle phase"
Setup Requirements
HerCycle requires a running WhoopClaw instance β an open-source FastAPI backend that handles Whoop OAuth, cycle tracking, and biometric storage. Search GitHub for "WhoopClaw" to find an implementation, or build your own against the Whoop Developer API.
Prerequisites:
1. Whoop API credentials β register at developer-dashboard.whoop.com to get your WHOOP_CLIENT_ID and WHOOP_CLIENT_SECRET
2. WhoopClaw running locally β clone, configure .env, and start the server (uvicorn main:app)
3. Whoop account connected β complete the OAuth flow via WhoopClaw's /whoop/authorize endpoint
Once running, configure WHOOPLAW_BASE_URL to point to your instance (default: http://localhost:8000).
Key endpoints HerCycle uses:
GET /whoop/recovery β latest recovery + HRVGET /cycle/current-phase?telegram_id= β current cycle phaseGET /cycle/predictions?telegram_id= β next period predictionGET /whoop/metrics/skin-temp β skin temperature trend (ovulation signal)Always pull live data before making recommendations. Do not rely on stale cached values.
Philosophy
> *"Every month I experience four seasons... in this season, certain sensitivity and capacity is amplified."* β ChloΓ© Zhao, Oscar-winning director (BBC 100 Women)
The goal is not to manage around the cycle. It's to move with it β scheduling, eating, training, socialising, and creating in alignment with what's naturally amplified. The cycle is the intelligence. HerCycle makes it legible.
π‘ Examples
Check current phase: > "What phase am I in?" / "What's my cycle season today?"
Phase-aware recommendation: > "Should I push hard at the gym today?" > "What should I eat this week?" > "Is this a good week for a big presentation?"
Trigger an action: > "Play music for my phase" / "Give me a playlist for my cycle phase"