Memlink Skill

Official skill for Memlink - Universal Memory for AI Agents.

Overview

This skill provides comprehensive memory management capabilities for AI agents using the Memlink MCP server. It enables persistent memory across sessions with advanced features like bulk operations, backup/restore, and detailed analytics.

Features

• Memory Management: Create, read, update, and delete memory entries
• Bulk Operations: Delete multiple entries by titles, tags, or patterns
• Search & Filter: Advanced search across all memory entries
• Backup & Restore: Complete backup and restore functionality
• Analytics: Detailed memory statistics and usage analytics
• Safety Features: Dry-run mode for bulk operations

Installation

Automatic Installation

# Via Skills (https://skills.sh)
npx skills rblez/memlink
npx skills https://github.com/rblez/memlink

# Install Memlink globally
npm install -g @rblez/memlink

# Create skill for your agent
memlink agent create <agent-type>

Manual Installation

Copy the SKILL.md file to your agent's skills directory:

# For Windsurf
cp SKILL.md ~/.codeium/windsurf/skills/memlink/SKILL.md

# For Cursor
cp SKILL.md ~/.cursor/skills/memlink/SKILL.md

# For Claude Desktop
cp SKILL.md ~/.claude/skills/memlink/SKILL.md

Available Tools

Core Memory Operations

• memory_read - Read all entries or specific entry by title
• memory_edit - Create or update memory entries
• memory_delete - Delete specific memory entries
• memory_search - Search across all memory entries
• memory_batch - Bulk create/update operations

Bulk Operations

• bulk_delete - Delete multiple entries by titles, tags, or patterns

  {
    "method": "tags",
    "value": "old,deprecated",
    "dry_run": true
  }

Backup & Restore

• backup_create - Create memory backups
• backup_restore - Restore from backup files
• backup_list - List available backups
• backup_delete - Delete specific backups
• backup_cleanup - Clean up old backups

Analytics

• memory_stats - Get detailed memory statistics
• memory_sync - Validate memory integrity

Usage Examples

Basic Memory Operations

// Save information to memory
{
  "tool": "memory_edit",
  "arguments": {
    "title": "UserPreferences",
    "content": "User prefers concise responses with technical details",
    "tags": ["preferences", "style"]
  }
}

// Retrieve information
{
  "tool": "memory_read",
  "arguments": {
    "title": "UserPreferences"
  }
}

Bulk Operations

// Safe bulk delete with dry run
{
  "tool": "bulk_delete",
  "arguments": {
    "method": "tags",
    "value": "test,temporary",
    "dry_run": true
  }
}

Backup Management

// Create backup before major changes
{
  "tool": "backup_create",
  "arguments": {}
}

// List available backups
{
  "tool": "backup_list",
  "arguments": {}
}

Memory Organization

Recommended entry titles:

• UserPreferences - Communication style, language preferences
• ProjectContext - Current project, goals, stack information
• TechStack - Technologies, frameworks, tools being used
• ImportantDecisions - Key architectural or project decisions
• SessionNotes - Temporary session-specific information

Best Practices

1. Always backup before bulk operations
2. Use dry_run mode for bulk deletions
3. Organize entries with consistent tags
4. Regular cleanup of outdated entries
5. Use search instead of reading all entries for large memories

Agent Compatibility

• ✅ Windsurf (Cascade)
• ✅ Cursor
• ✅ Claude Desktop
• ✅ Devin AI
• ✅ Claude Code

Configuration

The skill automatically connects to your local Memlink server. Make sure:

1. Memlink is installed: npm install -g @rblez/memlink
2. Server is running: memlink serve
3. MCP is configured for your agent

Troubleshooting

Common Issues

1. Connection refused: Start Memlink server with memlink serve
2. Memory not found: Initialize with memlink init
3. Permission denied: Check MCP configuration in your agent

Debug Commands

# Check Memlink status
memlink status

# List memories
memlink memory list

# Test server
memlink serve --verbose

Contributing

1. Fork the repository
2. Create feature branch
3. Submit pull request

License

MIT License - see LICENSE file for details.

Support

• Documentation: Memlink Docs
• Issues: GitHub Issues
• Discussions: GitHub Discussions