๐ฉบ memory-health-check
by @chongjie-ran
Performs a 6-dimension memory health check assessing integrity, freshness, bloat, orphans, duplicates, and coverage with optional auto-repair.
clawhub install memory-health-check๐ About This Skill
๐ฉบ memory-health-check
> Version: 1.0.0
> Skill ID: memory-health-check
> Status: Ready for Development
Quick Reference
| ้กน็ฎ | ๅ
ๅฎน |
| ---- | ---- |
| ๆ ธๅฟๅ่ฝ | 6็ปดๅ
ๅญๅฅๅบท่ฏๆญ๏ผๅฎๆดๆง/ๆฐ้ฒๅบฆ/่จ่็/ๅญคๅฟ/ๅป้/่ฆ็็๏ผ |
| ไธปๅ
ฅๅฃ | bin/health_check.sh |
| ไพ่ต | OpenClaw v2026.4.9+, sqlite3 |
Features (MVP)
1. Integrity scan โ DB corruption / checksum checks 2. Bloat detection โ DB size, file count, growth rate 3. Orphan detection โ Entries with zero inbound references 4. Freshness report โ Entry age distribution 5. Dedup scanner โ Duplicate / near-duplicate entries 6. Health score โ Aggregate 0โ100 score across all dimensions 7. Auto-repair โ Orphan cleanup on user approval
File Structure
memory-health-check/
โโโ SKILL.md # This file
โโโ bin/
โ โโโ health_check.sh # Main entry point
โ โโโ integrity_scan.py # DB corruption checks
โ โโโ bloat_detector.py # Size analysis
โ โโโ orphan_finder.py # Reference graph orphan detection
โ โโโ dedup_scanner.py # Duplicate detection
โ โโโ freshness_report.py # Entry age distribution
โ โโโ health_score.py # Aggregate scoring
โโโ scripts/
โ โโโ generate_report.py # Report generator
โ โโโ auto_repair.py # Cleanup script
โโโ config/
โ โโโ thresholds.yaml
โโโ reports/
โ โโโ .gitkeep
โโโ README.md
Usage
# Full health check
memory-health-check/bin/health_check.shWith auto-repair
memory-health-check/bin/health_check.sh --auto-repairSpecific dimensions only
memory-health-check/bin/health_check.sh --dims integrity,bloat
Health Score Dimensions
| Dimension | Healthy | Warning | Critical | |-----------|---------|---------|----------| | Integrity | โ | โ ๏ธ | ๐ด | | Freshness (>70%) | >70% | 40โ70% | <40% | | Bloat | <500MB | 500MBโ2GB | >2GB | | Orphans | 0% | 1โ5% | >5% | | Dedup | <2% | 2โ10% | >10% | | Coverage | >80% | 50โ80% | <50% |
Pricing
| Tier | Price | Features | |------|-------|----------| | Free | $0 | 1 scan/week, text report | | Pro | $9.90/mo | Unlimited scans, 6-dim diagnostics, auto-repair, 90-day history | | Bundle | $17.90/mo | dreaming-optimizer Pro + memory-health-check Pro |
Development
See: ``
๐ก Examples
# Full health check
memory-health-check/bin/health_check.shWith auto-repair
memory-health-check/bin/health_check.sh --auto-repairSpecific dimensions only
memory-health-check/bin/health_check.sh --dims integrity,bloat