reminders

reminders is a skill for Claude Code from metraton/gaia. It costs 108 tokens per session (1,253 once invoked), scanned A, original, MIT.

A reminder tool for one-time reminders, recurring routines, and notifications left by tasks or agents. It checks for due items when you use the system rather than running unattended in the background.

In plain words
What is it for?
Use it for requests such as reminding you tomorrow, repeating an action every week, or showing a pending notification at the next session.
Why use it?
It prevents forgotten tasks while making clear that reminders are not a scheduler or a background job runner.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the gaia plugin — 39 skills, 9 agents, 12 hooks shipped together

Good fit Use it for requests such as reminding you tomorrow, repeating an action every week, or showing a pending notification at the next session.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/metraton/gaia/reminders
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add metraton/gaia --skill reminders
Clone the repo
git clone --depth 1 https://github.com/metraton/gaia

Made for: Claude Code.

Or install gaia, the plugin that ships this one along with the rest of its 39 skills, 9 agents, 12 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for reminders

README.md
[![agentmods](https://agentmods.dev/badge/skills/metraton/gaia/reminders/github.svg)](https://agentmods.dev/skills/metraton/gaia/reminders)
Your own site
<a href="https://agentmods.dev/skills/metraton/gaia/reminders"><img src="https://agentmods.dev/badge/skills/metraton/gaia/reminders/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for reminders

Your own site · 80×15
<a href="https://agentmods.dev/skills/metraton/gaia/reminders"><img src="https://agentmods.dev/badge/skills/metraton/gaia/reminders.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 108 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,253 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00108 $0.01253
Opus 5.5 $0.00043 $0.00501
Sonnet 5.5 $0.00022 $0.00251
Haiku 4.5 $0.00011 $0.00125

Measured 21d ago against content hash 89f7b8687e06, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

reminders scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 21d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/reminders/SKILL.md · 68 lines

How it starts

The opening of the file, as written. The whole thing — 68 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Reminders

A reminder is a row that comes due, not a job that starts. Gaia has no scheduler, no daemon, no system timer and no unattended AI session: nothing runs while the user is away. A row is due when a read finds it open with its time passed, and the reads happen when the user is present -- the Recurring work pending line at session start and the N notifications due counter on the next prompt. A reminder for 16:00 shows after 16:00, the next time Gaia is used.

The three kinds

All three are gaia notifications rows; the kind decides how one ends.

Kind What it is ack does
report What a task or agent left behind; due at once marks it seen
reminder Once, at an absolute time (--at) closes it for good, also a year later
routine Recurring, by --cron or --every moves it to the next occurrence after now; missed ones collapse into one

Creating one

One sentence becomes exactly one gaia notifications add. The orchestrator runs it itself, with no dispatch.

  1. Read the time with gaia now. Nothing else in the session tells you the current local time, and a guessed clock or zone puts the reminder hours off.
  2. From that output, turn the phrase into an absolute local date and time -- "mañana a las 4" is tomorrow's date at 16:00, "el viernes" the next Friday, "en media hora" the time gaia now printed plus 30 minutes. A time with no zone is local. If the phrase gives no time, ask; do not invent one. A time already past is refused, and so is an --at without a date.
  3. Run the one command. A reminder takes --at YYYY-MM-DDTHH:MM, a routine takes one of --cron '<five fields>' (local time) or --every <90m|6h|1d|1w>.
  4. Return what the CLI prints (Added reminder #7, due Thu 2026-10-01 16:00 -03 (local time) and its now: line) so the user confirms the date. If it is wrong, gaia notifications cancel <id> and add it again.

"In half an hour", when gaia now printed now: Thu 2026-10-01 11:20 -03:00 (America/Santiago):

Read the full file on GitHub · 68 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 21d ago First seen · 68 lines · 108 tokens per session scan A 89f7b8687e06

Subscribe to this mod's changes

reminders is a skill published in the GitHub repository metraton/gaia (4 stars, last pushed today), licensed MIT. It adds 108 tokens to every session and 1,253 once invoked, about $0.0004 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-10-07.