---

name: search-memory version: "1.0.0" description: > Search the hierarchical memory system for relevant memories. Searches across all tiers (working, episodic, semantic) and returns ranked results. Use for context retrieval and pattern matching. Keywords: memory, search, retrieve, recall, context, similarity. metadata: domain: general category: memory requires-approval: false confidence: 0.9 mcp-servers: []

Search Memory

Preconditions

Before applying this skill, verify:

• Memory system is initialized
• Search query is meaningful
• Result limit is specified

Actions

1. Build Search Query

Prepare the semantic search query:

query: $search_text
user_id: $user_id
limit: $result_limit (default: 10)

2. Search Each Tier

Working Memory (exact + recency):

working_results = memory.search_working(query, limit=limit//3)

Episodic Memory (semantic + time decay):

episodic_results = memory.search_episodic(
    query=query,
    user_id=user_id,
    limit=limit//3
)

Semantic Memory (semantic + permanence):

semantic_results = memory.search_semantic(
    query=query,
    user_id=user_id,
    limit=limit//3
)

3. Merge and Rank Results

Combine results from all tiers:

• Apply tier-specific weights
• Remove duplicates
• Sort by relevance score
• Return top N results

Success Criteria

The skill succeeds when:

• All accessible tiers searched
• Results ranked by relevance
• Metadata includes source tier

Failure Handling

If search fails:

1. Return partial results from available tiers
2. Log which tiers were unreachable
3. Include error context in response

Examples

Input Context:

{
  "query": "nginx pod memory issues",
  "user_id": "k8s-monitor",
  "limit": 10
}

Expected Output:

{
  "results": [
    {
      "content": "Pod nginx-abc crashed due to OOM. Fixed by increasing limits.",
      "tier": "episodic",
      "score": 0.89,
      "timestamp": "2024-01-15T10:30:00Z"
    },
    {
      "content": "Nginx pods require 1Gi memory minimum for production workloads",
      "tier": "semantic",
      "score": 0.85,
      "pattern_type": "resource_requirement"
    }
  ],
  "total_searched": 3,
  "tiers_searched": ["working", "episodic", "semantic"]
}