People memories skill

---

name: people-memories

description: Capture short personal notes about people you mention, store them in a lightweight DB, and recall those details whenever you ask about them later. Use when you want to remember preferences, reminders, or the context around a person without digging through past chats.

---

# People memories skill

Purpose

Keep a short-lived, searchable memory vault about people you talk to so your assistant can recall follow-ups instantly. The skill handles:

Structure & storage

`~/.clawdbot/people-memory.json` now stores:

{
  "people": {
    "alex": {
      "displayName": "Alex",
      "notes": [
        {
          "timestamp": "2026-01-29T12:05:00Z",
          "note": "Likes cats and doing late-night music practice",
          "source": "voice",
          "tags": ["pets", "music"]
        }
      ]
    }
  },
  "index": {
    "music": ["alex"],
    "cats": ["alex"]
  }
}

CLI commands

Use the bundled script to manage the database:

skills/people-memories/scripts/people_memory.py <command> [options]

Auto capture (voice/chat)

The `extensions/people-memories` extension listens to `/voice-chat` transcripts. When you say something like “remember Alex likes cats,” it automatically runs the `remember` command and logs the note. The index updates in the background, and we keep confirmations quiet unless you explicitly ask for them.

Reminders & automation

Event metadata (type + date) is attached whenever a note mentions birthdays or anniversaries. A helper cron job runs `python3 skills/people-memories/scripts/people_memory.py reminders --days 0 --window 7 --format message` each morning and delivers the resulting digest over Telegram so you’re nudged about the next week’s birthdays/anniversaries without manual effort. If you prefer a different cadence or channel, rerun the command yourself or update the schedule.

Enhancements in this version

1. **Smart indexing** – Tags + keyword extraction keep the lookup index updated so searches find matching people even when you reuse adjectives.

2. **Summaries & exports** – Quickly produce a fact card or shareable Markdown/JSON of anyone’s notes.

3. **Voice integration + logging** – transcripts feed the database so you don’t type commands manually.

4. **Structured data** – normalized keys + timestamps plus tag metadata make it easy for other tools (cron, dashboards) to consume the memory store.

Next steps / nice-to-haves

Let me know which direction to automate next (priority filters, notifications, cross-agent sync, etc.)."}