Skip to main content
skill CX Codex

supermemory · supermemoryai — Claude Code skill: what it does, how to install

Guides agents on building with the Supermemory v5 API and SDKs. Helps add persistent memory, semantic chunk search, and user profiles to apps.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add supermemoryai/skills --skill supermemory -a claude-code
Open on GitHub

What supermemory does

This skill gives coding assistants exact specifications for Supermemory v5 across TypeScript and Python SDKs. All storage and retrieval operations are isolated within a single namespace. Instead of managing memory facts by hand, you submit text, files, or URLs under a stable identifier. The background engine parses the content, creates searchable chunks, and maintains a profile for each subject.

Background ingestion requires care during testing. The default dynamic dreaming mode can take minutes to process new records, leaving the profile empty right after creation. Switching to instant dreaming fixes this for automated tests, though it bills one extra operation per document. The skill also enforces v5 patterns, filtering out obsolete parameters like containerTag from older releases.

What it helps with

  • persist user context across chat sessions using Supermemory v5
  • run semantic searches over document chunks
  • maintain user profile buckets from unstructured notes
  • migrate legacy code away from deprecated v3 and v4 parameters

Example prompts for the agent

  • Write a TypeScript function to add a document with instant dreaming in namespace user_alex.
  • Show how to search memory chunks for a specific user profile using Python SDK v5.
  • Check this codebase for legacy Supermemory containerTag references and update them to v5.

How to install supermemory

1Skills CLI (Vercel)

npx skills add supermemoryai/skills --skill supermemory -a claude-code

2Manually: put the files in place

~/.claude/skills/supermemory/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/supermemory/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about supermemory

How do I install supermemory in Claude Code?

Run npx skills add supermemoryai/skills --skill supermemory -a claude-code. The tool installs the skill files and makes v5 API patterns available to your agent.

What does the supermemory skill do?

It provides call shapes, parameter rules, and filter formats for the Supermemory v5 API. This prevents assistants from outputting deprecated methods or mixing up namespaces.

What is required to connect to Supermemory v5?

You need an API key passed as a bearer token or in the SUPERMEMORY_API_KEY environment variable. SDKs are installed via npm i supermemory or pip install -U supermemory.

Similar skills

All skills for Agent setup: memory, context, orchestration →

supermemory by other authors comes first.

From the same set3

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor