๐ŸŽ Get the FREE AI Skills Starter Guide โ€” Subscribe โ†’
BytesAgainBytesAgain
๐Ÿฆ€ ClawHub

๐Ÿฉบ 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.

Versionv1.0.0
Downloads475
TERMINAL
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.sh

With auto-repair

memory-health-check/bin/health_check.sh --auto-repair

Specific 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.sh

With auto-repair

memory-health-check/bin/health_check.sh --auto-repair

Specific dimensions only

memory-health-check/bin/health_check.sh --dims integrity,bloat