Pill Reminder

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

bgoodwinstudio@bgoodwinstudio

Install

openclaw skills install @bgoodwinstudio/pill-reminder

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 took or didn't take
If took → logged ✅
If didn't take → general warning + "Not medical advice" disclaimer → then logged

Setup

Run once to initialize:

text

setup pill reminder

This 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:

text

⚠️ 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:

text

🔔 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

text

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

Printable Log Format

When print log [name] is called, output:

text

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.md with 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