mirror of
https://github.com/openclaw/openclaw.git
synced 2026-03-12 07:20:45 +00:00
9cce40d123
* feat(skills): add 'Use when / Don't use when' blocks to skill descriptions Based on OpenAI's Shell + Skills + Compaction best practices article. Key changes: - Added clear routing logic to skill descriptions - Added negative examples to prevent misfires - Added templates/examples to github skill - Included Blake's specific setup notes for openhue Skills updated: - apple-reminders: Clarify vs Clawdbot cron - github: Clarify vs local git operations - imsg: Clarify vs other messaging channels - openhue: Add device inventory, room layout - tmux: Clarify vs exec tool - weather: Add location defaults, format codes Reference: https://developers.openai.com/blog/skills-shell-tips * fix(skills): restore metadata and generic CLI examples --------- Co-authored-by: Peter Steinberger <steipete@gmail.com>
119 lines
3.0 KiB
Markdown
119 lines
3.0 KiB
Markdown
---
|
|
name: apple-reminders
|
|
description: Manage Apple Reminders via remindctl CLI (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output.
|
|
homepage: https://github.com/steipete/remindctl
|
|
metadata:
|
|
{
|
|
"openclaw":
|
|
{
|
|
"emoji": "⏰",
|
|
"os": ["darwin"],
|
|
"requires": { "bins": ["remindctl"] },
|
|
"install":
|
|
[
|
|
{
|
|
"id": "brew",
|
|
"kind": "brew",
|
|
"formula": "steipete/tap/remindctl",
|
|
"bins": ["remindctl"],
|
|
"label": "Install remindctl via Homebrew",
|
|
},
|
|
],
|
|
},
|
|
}
|
|
---
|
|
|
|
# Apple Reminders CLI (remindctl)
|
|
|
|
Use `remindctl` to manage Apple Reminders directly from the terminal.
|
|
|
|
## When to Use
|
|
|
|
✅ **USE this skill when:**
|
|
|
|
- User explicitly mentions "reminder" or "Reminders app"
|
|
- Creating personal to-dos with due dates that sync to iOS
|
|
- Managing Apple Reminders lists
|
|
- User wants tasks to appear in their iPhone/iPad Reminders app
|
|
|
|
## When NOT to Use
|
|
|
|
❌ **DON'T use this skill when:**
|
|
|
|
- Scheduling Clawdbot tasks or alerts → use `cron` tool with systemEvent instead
|
|
- Calendar events or appointments → use Apple Calendar
|
|
- Project/work task management → use Notion, GitHub Issues, or task queue
|
|
- One-time notifications → use `cron` tool for timed alerts
|
|
- User says "remind me" but means a Clawdbot alert → clarify first
|
|
|
|
## Setup
|
|
|
|
- Install: `brew install steipete/tap/remindctl`
|
|
- macOS-only; grant Reminders permission when prompted
|
|
- Check status: `remindctl status`
|
|
- Request access: `remindctl authorize`
|
|
|
|
## Common Commands
|
|
|
|
### View Reminders
|
|
|
|
```bash
|
|
remindctl # Today's reminders
|
|
remindctl today # Today
|
|
remindctl tomorrow # Tomorrow
|
|
remindctl week # This week
|
|
remindctl overdue # Past due
|
|
remindctl all # Everything
|
|
remindctl 2026-01-04 # Specific date
|
|
```
|
|
|
|
### Manage Lists
|
|
|
|
```bash
|
|
remindctl list # List all lists
|
|
remindctl list Work # Show specific list
|
|
remindctl list Projects --create # Create list
|
|
remindctl list Work --delete # Delete list
|
|
```
|
|
|
|
### Create Reminders
|
|
|
|
```bash
|
|
remindctl add "Buy milk"
|
|
remindctl add --title "Call mom" --list Personal --due tomorrow
|
|
remindctl add --title "Meeting prep" --due "2026-02-15 09:00"
|
|
```
|
|
|
|
### Complete/Delete
|
|
|
|
```bash
|
|
remindctl complete 1 2 3 # Complete by ID
|
|
remindctl delete 4A83 --force # Delete by ID
|
|
```
|
|
|
|
### Output Formats
|
|
|
|
```bash
|
|
remindctl today --json # JSON for scripting
|
|
remindctl today --plain # TSV format
|
|
remindctl today --quiet # Counts only
|
|
```
|
|
|
|
## Date Formats
|
|
|
|
Accepted by `--due` and date filters:
|
|
|
|
- `today`, `tomorrow`, `yesterday`
|
|
- `YYYY-MM-DD`
|
|
- `YYYY-MM-DD HH:mm`
|
|
- ISO 8601 (`2026-01-04T12:34:56Z`)
|
|
|
|
## Example: Clarifying User Intent
|
|
|
|
User: "Remind me to check on the deploy in 2 hours"
|
|
|
|
**Ask:** "Do you want this in Apple Reminders (syncs to your phone) or as a Clawdbot alert (I'll message you here)?"
|
|
|
|
- Apple Reminders → use this skill
|
|
- Clawdbot alert → use `cron` tool with systemEvent
|