AGENT SKILL

macos-reminders

Create, list, and manage macOS Reminders via AppleScript. Use when the user asks to create a reminder, add a to-do, make a task, set a reminder for something, or anything involving Apple Reminders on macOS. Triggers on requests like "remind me to buy milk", "add a to-do to call the dentist", "create a reminder for Friday", "add to my shopping list", "flag this as important". macOS only.

License 许可
MIT
最近更新
2026-05-17
Stars
★ 0
Forks
0

01 前言 Front Matter

name
macos-reminders
license
MIT
metadata
{ "author": "lucaperret", "version": "1.0.0", "openclaw": { "os": "macos", "emoji": "✅", "homepage": "https://github.com/lucaperret/agent-skills", "requires": { "bins": [ "osascript", "python3" ] } } }
description
Create, list, and manage macOS Reminders via AppleScript. Use when the user asks to create a reminder, add a to-do, make a task, set a reminder for something, or anything involving Apple Reminders on macOS. Triggers on requests like "remind me to buy milk", "add a to-do to call the dentist", "create a reminder for Friday", "add to my shopping list", "flag this as important". macOS only.
compatibility
Requires macOS with Reminders.app. Uses osascript (AppleScript) and python3 for JSON parsing.

02 资源文件 3

03 SKILL.md 正文

macOS Reminders

Manage Apple Reminders via $SKILL_DIR/scripts/reminders.sh. All date handling uses relative math (current date + N * days) to avoid locale issues (FR/EN/DE date formats).

Quick start

List reminder lists

Always list reminder lists first to find the correct list name:

"$SKILL_DIR/scripts/reminders.sh" list-lists

Create a reminder

echo '<json>' | "$SKILL_DIR/scripts/reminders.sh" create-reminder

JSON fields:

Field Required Default Description
name yes - Reminder title
list no default list Reminder list name (from list-lists)
body no "" Notes/details
offset_days no - Due date as days from today (0=today, 1=tomorrow)
iso_date no - Absolute due date YYYY-MM-DD (overrides offset_days)
hour no 9 Due time hour (0-23)
minute no 0 Due time minute (0-59)
priority no 0 Priority: 0=none, 1=high, 5=medium, 9=low
flagged no false Mark as flagged

List reminders

echo '<json>' | "$SKILL_DIR/scripts/reminders.sh" list-reminders

JSON fields:

Field Required Default Description
list no all lists Filter by list name
include_completed no false Include completed reminders

Interpreting natural language

Map user requests to JSON fields:

User says JSON
"remind me tomorrow at 2pm" offset_days: 1, hour: 14
"remind me in 3 days" offset_days: 3
"add to my shopping list" list: "Shopping" (match closest list name)
"high priority" or "important" priority: 1, flagged: true
"remind me on February 25 at 3:30pm" iso_date: "2026-02-25", hour: 15, minute: 30
"remind me next Monday" Calculate offset_days from today to next Monday
"flag this" flagged: true

For "next Monday", "next Friday" etc: compute the day offset using the current date. Use date command if needed:

# Days until next Monday (1=Monday)
target=1; today=$(date +%u); echo $(( (target - today + 7) % 7 ))

Example prompts

These are real user prompts and the commands you should run:

"Remind me to buy milk"

"$SKILL_DIR/scripts/reminders.sh" list-lists

Then:

echo '{"name":"Buy milk","list":"Reminders"}' | "$SKILL_DIR/scripts/reminders.sh" create-reminder

"Add a to-do to call the dentist tomorrow at 10am"

echo '{"name":"Call the dentist","offset_days":1,"hour":10}' | "$SKILL_DIR/scripts/reminders.sh" create-reminder

"Remind me to submit the report on February 28 — high priority"

echo '{"name":"Submit the report","iso_date":"2026-02-28","hour":9,"priority":1,"flagged":true}' | "$SKILL_DIR/scripts/reminders.sh" create-reminder

"Add eggs, bread, and butter to my shopping list"

echo '{"name":"Eggs","list":"Shopping"}' | "$SKILL_DIR/scripts/reminders.sh" create-reminder
echo '{"name":"Bread","list":"Shopping"}' | "$SKILL_DIR/scripts/reminders.sh" create-reminder
echo '{"name":"Butter","list":"Shopping"}' | "$SKILL_DIR/scripts/reminders.sh" create-reminder

"What's on my reminders?"

echo '{}' | "$SKILL_DIR/scripts/reminders.sh" list-reminders

"Show my work to-dos"

echo '{"list":"Work"}' | "$SKILL_DIR/scripts/reminders.sh" list-reminders

Critical rules

  1. Always list reminder lists first if the user hasn't specified one — use the closest matching list name
  2. Never use hardcoded date strings in AppleScript — always use offset_days or iso_date
  3. Confirm the list name with the user if the intended list is ambiguous
  4. Pass JSON via stdin — never as a CLI argument (avoids leaking data in process list)
  5. All fields are validated by the script (type coercion, range checks, format validation) — invalid input is rejected with an error message
  6. All actions are logged to logs/reminders.log with timestamp, command, list, and name
  7. Due date is optional — reminders without a due date are valid (undated tasks)
  8. Multiple items: when the user lists several items, create one reminder per item

04 同仓库更多 Skills

meghal86
meghal86/stacksignal

zvukogram

Text-to-Speech via Zvukogram API with SSML support. Use when you need to generate speech from text, create podcasts, voice notifications, or work with audio. Supports speed control, stress marks, English word transcription, and audio fragment merging.

★ 0
meghal86
meghal86/stacksignal

zohomail

Zoho Mail API integration with managed OAuth. Send, receive, and manage emails, folders, and labels. Use this skill when users want to send emails, read messages, manage folders, or work with email labels in Zoho Mail. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.

★ 0
meghal86
meghal86/stacksignal

zoho-recruit

Zoho Recruit API integration with managed OAuth. Manage candidates, job openings, interviews, and recruitment workflows. Use this skill when users want to read, create, update, or search recruitment data like candidates, job openings, interviews, and applications in Zoho Recruit. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.

★ 0
meghal86
meghal86/stacksignal

zoho-people

Zoho People API integration with managed OAuth. Manage employees, departments, designations, attendance, and leave. Use this skill when users want to read, create, update, or query HR data like employees, departments, designations, and forms in Zoho People. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.

★ 0
meghal86
meghal86/stacksignal

zoho-mail

Zoho Mail API integration with managed OAuth. Send, receive, and manage emails, folders, and labels. Use this skill when users want to send emails, read messages, manage folders, or work with email labels in Zoho Mail. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.

★ 0
meghal86
meghal86/stacksignal

zoho-inventory

Zoho Inventory API integration with managed OAuth. Manage items, sales orders, invoices, purchase orders, bills, contacts, and shipments. Use this skill when users want to read, create, update, or delete inventory items, sales orders, invoices, purchase orders, bills, or other inventory records in Zoho Inventory. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.

★ 0