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.
npx skills add supermemoryai/skills --skill supermemory -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/supermemory/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/supermemory/
1Skills CLI (Vercel)
npx skills add supermemoryai/skills --skill supermemory -a codex2Manually: put the files in place
.agents/skills/supermemory/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add supermemoryai/skills --skill supermemory -a cursor2Manually: put the files in place
.cursor/skills/supermemory/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install supermemoryai/skills supermemory2Manually: put the files in place
.github/skills/supermemory/SKILL.md1Skills CLI (Vercel)
npx skills add supermemoryai/skills --skill supermemory -a gemini-cli2Platform CLI
gemini skills install https://github.com/supermemoryai/skills --path supermemoryManually: put the files in place
.devin/skills/supermemory/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add supermemoryai/skills --skill supermemory -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.