# Memory Health Probe

> QMD memory system telemetry — measure index health, BM25 retrieval quality, coverage maps, and trend analysis. Use when running QMD memory backend and need diagnostics on retrieval quality, index freshness, or collection coverage.

- Skill: `modbender/memory-health-probe` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add modbender/memory-health-probe`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/memory-health-probe/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/memory-health-probe

---


# Memory Health Probe

Telemetry for QMD memory systems. Measures index health, retrieval quality, and coverage to catch degradation before it affects agent performance.

## Metrics Captured

1. **Index health** — file count, chunk count, index size, staleness
2. **BM25 quality** — hit rate + score distribution over canonical queries
3. **Gateway events** — session-memory saves, QMD armed events
4. **Coverage map** — which collections are hit for which query categories

## Usage

```bash
python3 scripts/memory_probe.py              # Run probe, log to Langfuse
python3 scripts/memory_probe.py --dry-run    # Print results only
python3 scripts/memory_probe.py --trend      # Show trend over stored snapshots
```

## Files

- `scripts/memory_probe.py` — Probe script with Langfuse integration