Docs/Agent Skill

Agent Skill for Claude Code

Manage your reminders with natural language directly from your terminal. The Remembered skill lets Claude Code create, list, update, and delete reminders through the REST API.

What is a Claude Code skill?

Skills are markdown files that teach Claude Code how to interact with specific tools and APIs. The Remembered skill gives Claude all the context it needs to work with your reminders, including endpoint documentation, authentication setup, and example workflows.

Setup

1. Install the skill

Run this one-liner to download the skill file directly from Remembered:

mkdir -p ~/.claude/skills/remembered && curl -o ~/.claude/skills/remembered/SKILL.md https://remembered.cc/api/skill

2. Generate an API key

Go to your Settings page and click "Generate API Key". Copy the key, it is only shown once.

3. Set your environment variable

Add the key to your shell profile so Claude Code can use it:

# Add to ~/.zshrc or ~/.bashrc
export REMEMBERED_API_KEY="sk_live_your_key_here"

Usage

Once installed, invoke the skill by typing /remembered in Claude Code followed by what you want to do:

/remembered remind me to call the dentist tomorrow at 2pm

Creates a one-time reminder for tomorrow at 14:00

/remembered list my active reminders

Lists all reminders with ACTIVE status

/remembered pause all my reminders

Updates every active reminder to PAUSED

/remembered set up a daily standup reminder at 9am for the next 30 days

Creates a recurring daily reminder with an end date

/remembered delete the dentist reminder

Finds and deletes the matching reminder

How it works

When you invoke the skill, Claude Code:

1Reads the skill file to understand the API endpoints and authentication
2Interprets your natural language request and maps it to the right API call
3Executes the curl command using your REMEMBERED_API_KEY
4Shows you the result in a readable format

Skill file contents

The skill file is a standard markdown document with YAML frontmatter. It is scoped to only use the Bash and Read tools, so it can make curl requests and read files but cannot modify your codebase. You can also copy the contents below and save it manually to ~/.claude/skills/remembered/SKILL.md.

downloadDownload SKILL.md

---
name: remembered
description: Manage reminders on remembered.cc via its REST API.
allowed-tools:
  - Bash
  - Read
---

# Remembered API Skill

Manage reminders on remembered.cc through its REST API.

## Setup

The API key must be set as an environment variable:
export REMEMBERED_API_KEY="sk_live_..."

Generate a key at https://remembered.cc/dashboard/settings

## Base URL
https://remembered.cc/api/v1

## Authentication
All requests require a Bearer token:
-H "Authorization: Bearer $REMEMBERED_API_KEY"

## Endpoints

### List reminders
curl -s https://remembered.cc/api/v1/reminders \
  -H "Authorization: Bearer $REMEMBERED_API_KEY" | jq

### Create a reminder
curl -s -X POST https://remembered.cc/api/v1/reminders \
  -H "Authorization: Bearer $REMEMBERED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"...","startDate":"YYYY-MM-DD","startTime":"HH:mm"}' | jq

### Update a reminder
curl -s -X PATCH https://remembered.cc/api/v1/reminders/ID \
  -H "Authorization: Bearer $REMEMBERED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status": "PAUSED"}' | jq

### Delete a reminder
curl -s -X DELETE https://remembered.cc/api/v1/reminders/ID \
  -H "Authorization: Bearer $REMEMBERED_API_KEY"

## repeatRule examples
One-time:  {"type": "none"}
Daily:     {"type": "interval", "intervals": [{"every": 1, "period": "day"}]}
Weekly:    {"type": "weekly", "days": ["monday", "friday"]}
Monthly:   {"type": "monthly", "positions": [1, 15]}

Full file: https://remembered.cc/api/skill

Using with other AI tools

The Remembered REST API works with any tool that can make HTTP requests. If you are building custom agents, automations, or integrations, check the API documentation for the full endpoint reference.

Back to Help Center