sublimecodersublimecoder/aios/skills/reminders/SKILL.md

reminders

Skill2 starsChanged 55 days agoMITView on GitHub

Apple Reminders via rem CLI: add, list, search, update, complete, delete.

Installs packages

17 other projects use a version of this; 0 new projects in the last 4 weeks, against 1 the 4 before.

Adopted by

Cooling: 0 new projects took it in the last 4 weeks, 0× the 4 weeks before.thin data

Sep 2026Oct 2026Nov 2026

New projects taking a version of this file each week, over the 8 weeks our latest run read: only 1 in all, so this is a hint, not a trend.

Most recently taken up by

yourbeckett/beckett-for-claudetheir own version, first seen Nov 1, 2026
robinalexandre/claude-code-kittheir own version, first seen Nov 1, 2026
RumbleJack56/skillstheir own version, first seen Oct 20, 2026
steipete/agent-scriptsword for word, first seen Oct 20, 2026
metraton/gaiatheir own version, first seen Oct 13, 2026
microsoft/aibast-agents-librarytheir own version, first seen Oct 13, 2026

Used with

Projects with it also use calendar.

Other files people use alongside this one.

jacobraskSkill
calendar
Interact with Apple Calendar via AppleScript. Use when the user asks to check calendar, view events, create events, manage schedule, find free time, or list calendars. Triggers include "my calendar", "my schedule", "calendar events", "create event", "add to calendar", "what's on my calendar", "free time", "available slots", "upcoming events", "today's events". Requires macOS with Calendar.app.
Also in 4 projects that use this

Other versions17 projects use a version of this.
Word for word · 1
steipete/agent-scripts★ 7.4k100% same
Edited · 0
None found.
Wrote their own version · 16
kellyvv/PhoneClaw★ 1.3ksame name
brianharms/reminder-watch★ 63same name
JinyangWang27/people-context★ 60same name
Deibler/edmund-harness★ 24same name
microsoft/aibast-agents-library★ 8same name
jholhewres/devclaw-skills★ 4same name
metraton/gaia★ 4same name
eddmann/jeeves★ 2same name
montagao/skills★ 2same name
robinalexandre/claude-code-kit★ 2same name
6 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository7 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- ai-tellsSkill
- create-cliSkill
- github-deep-reviewSkill
- markdown-converterSkill
- one-passwordSkill
- video-transcript-downloaderSkill

The file

We split this skill into the rules it gives an agent

7 rules. 0 are common, 6 are distinctive, and 1 is very specific to this project.

0
Common
Most of the 15 edited versions we read keep these.
6
Distinctive
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.

Common
Distinctive
Very specific

Very specific:
Use this for Apple Reminders tasks.
line 8
Distinctive:
Use JSON for anything scripted or verified:
line 33
Distinctive:
Default: add directly, then verify by search/show.
line 43
Distinctive:
Always read back after writes.
line 72
Distinctive:
Use executable task titles.
line 85
Distinctive:
Use the default list unless the user names a list or the category is obvious.
line 88
Distinctive:
Do not add calendar events here.
line 89

“Common” is measured: kept by at least 6 in 10 of the 15 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.

Files

SKILL.md

Reminders

Use this for Apple Reminders tasks. Prefer rem over Things/AppleScript when the user wants an AI-friendly personal todo backend on macOS.

Tool

CLI: rem
Repo: https://github.com/BRO3886/rem
Install:

GOBIN=/opt/homebrew/bin go install github.com/BRO3886/rem/cmd/rem@latest

rem uses EventKit for normal reads/writes. It may need Reminders permission for the calling app in System Settings > Privacy & Security.

Start

Check access:

rem lists -o json
rem today -o json

Use JSON for anything scripted or verified:

rem list --incomplete -o json
rem search "flight" -o json
rem show <id> -o json

Add Tasks

Default: add directly, then verify by search/show.

rem add "Book LHR-SFO nonstop business flight" --due "tomorrow 9am" --priority high --notes "Nonstop only." -o json
rem search "LHR-SFO" -o json

Useful flags:

--list "Name": target list
--due "tomorrow 9am": due date/time; natural language is supported
--priority high|medium|low|none
--notes "text"
--url https://...
--silent: due date without notification
--remind-me 15m: alarm before due time
--repeat daily|weekly|monthly|yearly

Update / Complete / Delete

Find the UUID first, then mutate by id or unique short id:

rem search "flight" -o json
rem update <id> --name "New title" --due "friday 2pm" --notes "..." -o json
rem complete <id> -o json
rem delete <id> --force

Always read back after writes; do not trust exit status alone.

Lists

rem lists --count -o json
rem list-mgmt create "Travel"
rem list-mgmt rename "Old" "New"
rem list-mgmt delete "Name" --force

Conventions

Use executable task titles. Rewrite vague notes into the next concrete action.
Preserve user wording when they clearly want verbatim capture.
Split multiple unrelated actions into separate reminders.
Use the default list unless the user names a list or the category is obvious.
Do not add calendar events here; use calendar tooling instead.
For current date math, run date; do not guess.

Gotchas

macOS only.
First run may fail with reminders access denied until the calling app has Reminders permission.
The default local list may be localized, e.g. Erinnerungen.
rem search is plain query search, not shell regex.
--due creates an alarm at the due time unless --silent is passed.
Flagged reminders use private ReminderKit under the hood and may be more OS fragile than ordinary CRUD.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free