qavr-memory

Rank vector-store memories by learned q-values to improve retrieval relevance.

Updated Jan 26, 2026
One-click install
npx skills add https://github.com/kimasplund/clawdbot-skills-pack --skill qavr-memory
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qavr-memory
Source: https://github.com/kimasplund/clawdbot-skills-pack/tree/main/memory-learning/qavr-memory
Command: npx skills add https://github.com/kimasplund/clawdbot-skills-pack --skill qavr-memory

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Memory systems often retrieve semantically similar information but fail to promote frequently useful memories. QAVR adds learned utility scoring to prioritize memories that led to successful outcomes, improving retrieval relevance over time.

Core Features & Use Cases

  • Learned Q-Value scoring to rank memories by actual usefulness
  • Cold-to-warm context adaptation: becomes active after sufficient interactions
  • Integrates with a vector store to re-rank results for agents performing memory recall, planning, or debugging

Quick Start

Use qavr-memory to rank memories by integrating with your memory store and running a query like qavr_query(query_text, collection, n_results=5) to obtain prioritized results.

Frequently Asked Questions about qavr-memory

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I rank memories by usefulness in a memory-augmented agent?

Rank memories by usefulness by applying learned Q-value scoring to re-rank vector-store results, prioritizing memories that previously led to successful outcomes. This enables warm-context prioritization for agents handling long-running conversations.

How does Q-value scoring improve retrieval relevance over standard vector search?

Q-value scoring improves retrieval relevance by storing per-memory utility values and updating them based on task outcomes, ensuring frequently useful memories are promoted over merely semantically similar ones.

Can I use this memory ranking approach for long-running conversation histories?

Yes, this memory ranking approach is designed for long-running conversation histories and knowledge bases, applying cold-to-warm context adaptation that becomes active after sufficient interactions to re-rank vector-store results.

What's the best way to prioritize frequently useful memories in a Python knowledge base?

Prioritize frequently useful memories in a Python knowledge base by integrating Q-value scoring with your vector store and running a query like qavr_query to obtain prioritized results based on actual usefulness.

Why does my vector store retrieve semantically similar information but fail to promote useful memories?

Vector stores fail to promote useful memories because they rely solely on semantic similarity. Adding learned utility scoring updates per-memory Q-values on outcomes to re-rank results and improve retrieval relevance over time.

When should I not use learned utility scoring for memory retrieval?

Avoid learned utility scoring for memory retrieval during cold-start periods with insufficient interactions, as the Q-value ranking requires outcome data to adapt from cold to warm context and effectively prioritize memories.