Agent skill

Reminders

by steipete in steipete/agent-scripts

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

MITAuto-check passed

Install Reminders

skills CLI
$ npx skills add steipete/agent-scripts --skill reminders -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install steipete/agent-scripts reminders --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/steipete/agent-scripts.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/reminders .claude/skills/reminders && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
reminders
GitHub stars
7.3k
Token cost
~661 tokens
SKILL.md length
256 words
Files
1
Skills in repo
45
Repo updated
First seen
Licence
MIT

At a glance

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

  • SKILL.md covers Tool, Start, Add Tasks and Update / Complete / Delete, plus 3 more sections
  • Calls go; reaches github.com

What it does

Reminders is an agent skill from steipete/agent-scripts. Apple Reminders via rem CLI: add, list, search, update, complete, delete.

Its SKILL.md is about 660 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Scripts for agents, shared between my repositories. The licence is MIT.

Example prompts

  • “/reminders”

What it can do on your machine

Read from SKILL.md and the folder at commit 79150cf. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • go

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Reminders loads about 661 tokens when it runs. Until then it costs about 21 tokens; SKILL.md has 256 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~21
When it runs · the whole SKILL.md, loaded when a task matches
~661

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from steipete/agent-scripts at commit 79150cf, republished under its MIT licence (© steipete). 256 words, ~661 tokens.

Download SKILL.mdSave it as .claude/skills/reminders/SKILL.md (or your agent's skills folder).
name
reminders
description
Apple Reminders via rem CLI: add, list, search, update, complete, delete.

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

bash
rem lists -o json
rem today -o json

Use JSON for anything scripted or verified:

bash
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.

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

bash
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

bash
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.

© steipete, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/reminders of steipete/agent-scripts.

Open the folder on GitHubat commit 79150cf

Compare with similar skills

Reminders next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Reminders compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Reminders this skillsteipete/agent-scripts7.3k—~661Automated safety check: PassMIT
Apple Reminderstrpc-group/trpc-agent-go1.8k8 repos~776Automated safety check: PassApache-2.0
Prismer Apple RemindersPrismer-AI/PrismerCloud1.6k2 repos~1.3kAutomated safety check: PassMIT
Apple Containersickn33/agentic-awesome-skills47k1 repos~2.5kAutomated safety check: PassApache-2.0
Apple Hignexu-io/open-design100k—~332Automated safety check: PassApache-2.0
Apple RemindersAtlasOmnia/donna-starter125—~1.3kAutomated safety check: PassMIT

Similar skills

  • Apple Reminders

    trpc-group/trpc-agent-go

    Manage Apple Reminders via remindctl CLI (list, add, edit, complete, delete).

    1.8k GitHub starsUsed in 8 repos~776 tokens
    Productivity & AutomationAuto-check passed
  • Prismer Apple Reminders

    Prismer-AI/PrismerCloud

    Apple Reminders via remindctl: add, list, complete. An agent skill from Prismer-AI/PrismerCloud.

    1.6k GitHub starsUsed in 2 repos~1.3k tokens
    Productivity & AutomationAuto-check passed
  • Apple Container

    sickn33/agentic-awesome-skills

    Build, run, and manage OCI/Linux containers as lightweight per-container VMs on Apple-silicon macOS using Apple's open-source container CLI, no Docker daemon required.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    DevOps & CloudAuto-check passed
  • Apple Hig

    nexu-io/open-design

    Apple Human Interface Guidelines as 14 agent skills covering platforms, foundations, components, patterns, inputs, and technologies for iOS, macOS, visionOS, watchOS, and tvOS.

    100k GitHub stars~332 tokensUpdated today
    MobileAuto-check passed
  • Apple Reminders

    AtlasOmnia/donna-starter

    apple-reminders — Apple Reminders via remindctl: add, list, complete.

    125 GitHub stars~1.3k tokensUpdated 19 days ago
    Productivity & AutomationAuto-check passed
  • Apple Notes Search

    sickn33/agentic-awesome-skills

    Semantic + keyword search and connection-discovery across the user's own Apple Notes via the apple-notes MCP server.

    47k GitHub starsUsed in 1 repo~2k tokens
    Agent WorkflowsAuto-check passed

More from steipete/agent-scripts

All 45 skills in this repo
  • Mac Fleet Maintenance

    steipete/agent-scripts

    Inventories and maintains a fleet of Macs from a desired-state file: package updates, repo and Xcode sync, and disk, backup and security health reports.

    7.3k GitHub stars~4.8k tokensUpdated 4 days ago
    Auto-check passed
  • Agent Transcript for PRs

    steipete/agent-scripts

    Finds a coding agent's session log, trims and redacts it, and inserts it into a GitHub PR or issue only when the user has asked for a transcript.

    7.3k GitHub starsUsed in 1 repo~698 tokens
    Auto-check passed
  • Parallels macOS VM Lab

    steipete/agent-scripts

    Uses a clean Parallels macOS VM to test GUI automation, TCC permission prompts and screenshot tools like Peekaboo, verifying results from outside the guest.

    7.3k GitHub stars~1.8k tokensUpdated 4 days ago
    Auto-check passed
  • ClawSweeper Status

    steipete/agent-scripts

    Reports ClawSweeper's status with a bundled script: workflow health, active workers, queue health and recently merged, reviewed, commented and closed items.

    7.3k GitHub stars~972 tokensUpdated 4 days ago
    Auto-check passed
  • GitHub Project Triage

    steipete/agent-scripts

    Produces maintainer-facing triage cards for a project's GitHub issues and pull requests, each with its URL, risk, test state, blockers and a next action.

    7.3k GitHub stars~4k tokensUpdated 4 days ago
    Auto-check passed
  • Nano Banana Image Generation

    steipete/agent-scripts

    Generates and edits images with Google's Nano Banana 2 (Gemini 3.1 Flash Image) through a uv script, with a draft-then-final workflow and sizes from 512 to 4K.

    7.3k GitHub stars~1.4k tokensUpdated 4 days ago
    Auto-check passed

Questions about Reminders

What does Reminders do?

Apple Reminders via rem CLI: add, list, search, update, complete, delete. Reminders is an agent skill from steipete/agent-scripts. Apple Reminders via rem CLI: add, list, search, update, complete, delete.

How do I install Reminders in Claude Code?

Run `npx skills add steipete/agent-scripts --skill reminders -a claude-code`. Or copy the skill folder (skills/reminders in steipete/agent-scripts) into .claude/skills/reminders in your project. Claude Code loads it when a task matches its description.

How do I install Reminders in Codex?

Run `npx skills add steipete/agent-scripts --skill reminders -a codex`. Or copy the skill folder (skills/reminders in steipete/agent-scripts) into .agents/skills/reminders in your project. Codex loads it when a task matches its description.

Can I use Reminders in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add steipete/agent-scripts --skill reminders -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/reminders, .gemini/skills/reminders, .github/skills/reminders and .opencode/skills/reminders in your project.

What does Reminders need to run?

Going by SKILL.md and its folder, Reminders needs the command-line tools its instructions call (go).

Does Reminders access the network?

SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Reminders safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Reminders use?

Reminders is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Reminders use?

About 661 tokens (SKILL.md is roughly 2.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Reminders?

Skills that share tags, products or a category with Reminders: Apple Reminders (trpc-group/trpc-agent-go, 1.8k stars), Prismer Apple Reminders (Prismer-AI/PrismerCloud, 1.6k stars), Apple Container (sickn33/agentic-awesome-skills, 47k stars) and Apple Hig (nexu-io/open-design, 100k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Reminders?

steipete (a GitHub user) maintains it in steipete/agent-scripts, which has 7,273 GitHub stars. The repository holds 45 skills in this directory. The repository was last updated on October 4, 2026.

Source: steipete/agent-scripts on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.