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:
- Cron fires → reminder sent to your configured channel
- You reply
tookordidn't take - If
took→ logged ✅ - If
didn't take→ general warning + "Not medical advice" disclaimer → then logged
Setup
Run once to initialize:
setup pill reminderThis creates pills.md in your workspace. You'll answer:
- Channel — GroupMe, Discord, Telegram, etc.
- Your name — for your profile
- 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:
- Ask for channel preference
- Ask for profile name
- Offer to add first pill immediately
- Create
pills.mdwith skeleton profile - Create cron job(s) for each dose time
On add family [name]:
- Create new profile section in
pills.md - 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