72 lines
4.4 KiB
Markdown
72 lines
4.4 KiB
Markdown
---
|
||
name: remind
|
||
description: >-
|
||
Create recurring reminders for tasks. Use when the user wants to set up a
|
||
reminder for something they need to do regularly, or when they mention tasks
|
||
they keep forgetting. Also handles listing and removing reminders. Triggers on
|
||
words like "remind", "reminder".
|
||
---
|
||
|
||
# Remind
|
||
|
||
Create, list, and manage recurring reminders for tasks.
|
||
|
||
## CRUD Script
|
||
|
||
All mutations to `reminder.yaml` go through `scripts/remind_edit.py` (paths in this skill are relative to the skill directory).
|
||
|
||
Run via: `uv run scripts/remind_edit.py <subcommand>`
|
||
|
||
Subcommands:
|
||
|
||
- **`list`** — prints JSON `{"reminders": [...]}`.
|
||
- **`add --text "..." --cron "EXPR" [--cron "EXPR"]`** — add recurring reminder; validates cron syntax.
|
||
- **`add --text "..." --at "ISO_DATETIME" [--at "ISO_DATETIME"]`** — add one-time reminder(s); `--at` is repeatable.
|
||
- **`add --text "..." --at "ISO" --cron "EXPR"`** — combine one-time and recurring times in one entry.
|
||
- **`add --text "..." --random-times-per-day N --random-window "HH:MM-HH:MM" [--random-days "1-5"] [--random-from "YYYY-MM-DD"] [--random-until "YYYY-MM-DD"]`** — random but deterministic times: fires `N` times per day at random moments inside the window. Use when the user wants something a few times a day without a fixed clock time (e.g. "remind me to drink water a few times during the day"). `--random-days` is a cron day-of-week filter; `--random-from` / `--random-until` bound the active period. Minimum gap between fires is a fixed constant in `scripts/random_times.py`. Combinable with `--at` / `--cron`.
|
||
- **`remove --keyword "..."`** — removes by case-insensitive substring match. Returns error JSON if 0 or >1 matches.
|
||
|
||
All outputs are JSON. Errors go to stderr with non-zero exit code.
|
||
|
||
## Create Workflow
|
||
|
||
1. **Identify the task** — What does the user want to be reminded about? If unclear, ask.
|
||
2. **Check for duplicates** — Run `remind_edit.py list` and compare existing reminder texts against the new one. If a similar reminder already exists:
|
||
- Show the user the existing reminder
|
||
- Ask whether they really want a duplicate, or want to modify the existing one
|
||
- Only proceed if the user explicitly confirms
|
||
3. **Determine frequency** — Ask how often the reminder should fire. Suggest common options:
|
||
- Every N minutes/hours/days
|
||
- Specific time of day (e.g. "every weekday at 9am")
|
||
- Specific day of week/month
|
||
- One-time at a specific datetime
|
||
- A few times a day at random moments (use the `--random-*` flags)
|
||
4. **Create the cron expression(s) or `at` field** — Map user input to cron syntax for recurring reminders, or ISO datetime for one-time reminders.
|
||
5. **Add via script** — Run a single `add` call combining all times (see CRUD Script for the exact flags). **Never call `add` multiple times for the same task** — put all times into one call.
|
||
6. **Confirm** — Show the user what was created (text, schedule).
|
||
|
||
## List Workflow
|
||
|
||
1. Run `uv run remind_edit.py list` and parse the JSON output.
|
||
2. Present all reminders in a table with columns: number, task, schedule.
|
||
3. Convert each schedule to human-readable text **in the user's language** (e.g. "every day at 9:00", "every Tuesday at 9:00"). For a `random` block, describe it like "5× a day at random between 9:00–21:00, Mon–Fri" (include `days`/`from`/`until` only if present).
|
||
4. If `reminders` is empty, say so.
|
||
|
||
## Remove / Done Workflow
|
||
|
||
1. Run `uv run remind_edit.py remove --keyword "..."`.
|
||
2. If exit code is non-zero, read the error JSON:
|
||
- `"no match"` → tell the user no reminder matches the keyword.
|
||
- `"ambiguous"` → show the matches and ask the user to be more specific.
|
||
3. If success, confirm what was removed.
|
||
|
||
## Rules
|
||
|
||
- **Respond to the user in their own language** (e.g. Czech) — this skill is written in English, but user-facing messages adapt to the user's language.
|
||
- **Never edit `reminder.yaml` directly** — no `edit_file`, `write_file`, or any direct write. All mutations go exclusively through `scripts/remind_edit.py`.
|
||
- **Read via the `list` subcommand** — never read the YAML file directly; always `remind_edit.py list`.
|
||
- Always confirm the reminder text and frequency with the user before creating.
|
||
- When listing, always show a human-readable schedule.
|
||
- Completed or removed reminders are deleted from `reminder.yaml` entirely — no `done` field, no `status` field.
|
||
- Timezone is always `Europe/Prague` unless the user explicitly requests otherwise.
|