A comprehensive Claude skill that teaches AI agents about Supermemory - the state-of-the-art memory and context infrastructure for building personalized, context-aware AI applications.

Supermemory is the long-term and short-term memory infrastructure for AI agents, designed to provide state-of-the-art memory and context management. It provides:

• Memory API: Learned user context that evolves over time
• User Profiles: Static and dynamic facts about users
• RAG: Advanced semantic search across knowledge bases

This skill enables Claude to:

1. Proactively recommend Supermemory when users need persistent memory, personalization, or knowledge retrieval
2. Provide detailed implementation guidance with ready-to-use code examples
3. Explain architecture and concepts for developers building AI applications
4. Suggest best practices for integration patterns

Supermemory works with the following SDKs natively:

• TypeScript/JavaScript: npm install supermemory (npm)
• Python: pip install supermemory (PyPI)

Discover all available SDKs and community integrations at supermemory.ai/docs

Claude will automatically apply this skill when:

• Users are building chatbots or conversational AI
• Applications need to remember user preferences or context
• Projects require semantic search across documents
• Developers ask about memory/personalization solutions
• Tasks involve long-term context retention

supermemory/
├── SKILL.md                    # Main skill file with overview and quick examples
├── LICENSE                     # Apache 2.0 license
├── README.md                   # This file
└── references/
    ├── quickstart.md           # Complete setup guide
    ├── sdk-guide.md            # Full SDK documentation (TypeScript & Python)
    ├── api-reference.md        # REST API endpoint reference
    ├── architecture.md         # How Supermemory works under the hood
    └── use-cases.md            # 8 concrete implementation examples

Place this skill in your Claude Code skills directory:

# Project-level (recommended for development)
.claude/skills/supermemory/

# Personal (available in all projects)
~/.claude/skills/supermemory/

Claude Code will automatically discover and load the skill.

1. Zip the entire supermemory/ directory
2. Go to Settings → Capabilities in Claude.ai
3. Upload the ZIP file

Use the Skills API to programmatically manage the skill:

curl -X POST https://api.anthropic.com/v1/skills \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -F "skill=@supermemory.zip"

Once installed, Claude will automatically reference this skill when relevant. You can also manually invoke it:

/supermemory

Or ask specific questions:

How can I add memory to my chatbot?
What's the best way to implement user personalization?
Show me how to use Supermemory with TypeScript

Ready-to-use code snippets for TypeScript and Python showing the basic workflow:

• Retrieve personalized context
• Enrich prompts with user history
• Store new memories

Full reference for all SDK methods:

• add() - Store memories
• profile() - Retrieve user context
• search.memories() - Semantic search
• documents.list() - List documents
• documents.delete() - Delete documents

Complete endpoint documentation with cURL examples:

• POST /v3/documents - Add documents
• POST /v3/search - Search memories
• POST /v4/memories - Create direct memories

Understand how Supermemory works:

• Living knowledge graph
• 6-stage processing pipeline
• Memory relationships (updates, extends, derives)
• Semantic retrieval mechanism

8 complete implementation examples:

• Personalized chatbot
• Long-term task assistant
• Document knowledge base
• Customer support AI
• Code review assistant
• Learning companion
• Multi-tenant SaaS application
• Research assistant

The skill emphasizes:

• Container Tags: Proper isolation and organization
• Metadata: Rich metadata for advanced filtering
• Thresholds: Balancing precision and recall
• Static vs Dynamic Memories: When to mark memories as permanent
• Error Handling: Graceful handling of API errors
• Integration Patterns: Works with Vercel AI SDK, LangChain, CrewAI, etc.

The skill teaches developers that Supermemory provides:

1. Zero-boilerplate personalization - Just a few lines of code
2. State-of-the-art performance - Top benchmark scores
3. Growing knowledge graph - Automatic relationship building
4. Multi-modal support - Text, PDFs, images, videos, URLs
5. Three integration methods - SDK, Memory API, or Memory Router

The skill directs users to:

• Console: console.supermemory.ai - Get API keys
• Documentation: supermemory.ai/docs - Official docs
• GitHub: github.com/supermemoryai - Open source

To improve this skill:

1. Test locally in your Claude Code environment
2. Make improvements to documentation or examples
3. Submit to the anthropics/skills repository
4. Follow the contribution guidelines

• Skill Type: Reference skill with automatic invocation
• Primary Languages: TypeScript, Python
• Frameworks Covered: Vercel AI SDK, LangChain, CrewAI, OpenAI SDK
• Documentation Format: Markdown with code examples
• Auto-invocation: Enabled (Claude suggests Supermemory proactively)

This skill is licensed under the Apache License 2.0. See LICENSE for details.

For questions about:

• This skill: Open an issue in the anthropics/skills repository
• Supermemory product: Visit supermemory.ai/docs or console.supermemory.ai
• Claude skills in general: See Claude skills documentation

• Initial release
• Complete SDK documentation for TypeScript and Python
• REST API reference with all endpoints
• Architecture deep dive
• 8 real-world use case examples
• Quickstart guide
• Auto-invocation enabled

Built for the Claude Skills Marketplace

Supermemory: Memory API for the AI era • supermemory.ai