Pill Reminder

Sends scheduled medication reminders with tracking, supports multiple users, refill alerts, and generates adherence reports; not a substitute for medical adv...

Pill Reminder Skill

⚠️ Important: Not Medical Advice This skill is for medication reminder and tracking purposes only. It does not provide medical guidance, diagnoses, or treatment recommendations. Always consult a healthcare professional regarding any medication decisions.

---

Skill ID: pill-reminder
Version: 1.0.0
Author: Brian Goodwin

---

What It Does

Sends daily medication/supplement reminders at user-defined times. Tracks adherence with a printable log for doctor visits. Supports multiple people (user + family members). Includes refill reminders.

Reminder Flow:

1. Cron fires → reminder sent to your configured channel
2. You reply took or didn't take
3. If took → logged ✅
4. If didn't take → general warning + "Not medical advice" disclaimer → then logged

---

Setup

Run once to initialize:

setup pill reminder

This creates pills.md in your workspace. You'll answer:

1. Channel — GroupMe, Discord, Telegram, etc.
2. Your name — for your profile
3. First pill — name, pill count, refill threshold, time(s)

---

Commands

Speak naturally. The skill parses your intent.

Command	Description
add pill [name] [count] at [time]	Add a pill. Count = current number in bottle. Times comma-separated for multiple daily doses. Default refill threshold = 7.
add pill [name] [count] at [time] refill [N]	Same with custom refill alert threshold.
remove pill [name]	Remove a pill from your profile.
add family [name]	Add a new person profile (child, spouse, etc.) under your account.
list pills	Show all pills and schedules for your profile.
list family	Show all profiles in your household.
print log [name]	Output a doctor-friendly adherence report for a person.
set channel [channel]	Change where reminders are sent (groupme, discord, telegram, etc.)
show config	Display the current pills.md content.
help pill-reminder	Show this command list.

---

"Didn't Take" Warning Language

When user replies didn't take, send this before logging:

⚠️ Skipping doses can reduce effectiveness. Consistency matters for most medications to work as intended. If missing doses becomes a pattern, consider talking with your doctor or pharmacist.

*This is not medical advice.*

---

Refill Alert Format

When pill count drops to refill threshold:

🔔 Refill Reminder: [pill name] is running low ([count] left)

Fires automatically when logging a took that brings count to or below threshold.

---

Cron Job Per Pill

Each pill dose gets its own cron job. Format: X Y * * 1-6 (Mon-Sat at specified hour/min).

When adding a pill with multiple times, create one cron per dose.

---

Reminder Message Format

💊 Pill Reminder — [profile name]
[pill name] ([count] left)
Reply: `took` or `didn't take`

---

Printable Log Format

When print log [name] is called, output:

PILL REMINDER — ADHERENCE REPORT
Generated: [DATE]
Person: [NAME]

====================================
PILL: [pill name]
------------------------------------
TAKEN:
  - [date]
  - [date]
  - [date]
MISSED:
  - [date]
  - [date]

Adherence Rate: [X]%
Refills Remaining (est): [N]
====================================

Notes: [any logged notes]

---
Prepared for medical review.

---

Data Files

File	Location	Purpose
Config	~/.openclaw/workspace/pills.md	All profiles, pills, schedules, counts
Log	~/.openclaw/workspace/pill-log.md	Adherence history, dates taken/missed

---

Setup Behavior

On first setup pill reminder:

1. Ask for channel preference
2. Ask for profile name
3. Offer to add first pill immediately
4. Create pills.md with skeleton profile
5. Create cron job(s) for each dose time

On add family [name]:

1. Create new profile section in pills.md
2. Ask if they want to add pills for this person now

---

Technical Notes

• Channel must be configured in OpenClaw before use
• "took" / "didn't take" matching is case-insensitive
• Times support 12hr format (8am, 8:00 AM, etc.)
• Reminders fire Mon-Sat by default
• All data stored locally — no cloud, no external API calls except to your messaging channel