# Memory Insights

> Knowledge base analytics and health monitoring - file statistics, health scoring, keyword extraction, activity trends, gap detection, and comprehensive reporting

- Skill: `chainlesschain/memory-insights` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add chainlesschain/memory-insights`
- Raw SKILL.md: https://api.skillmd.com/api/skills/chainlesschain/memory-insights/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- License: MIT
- Author: chainlesschain (https://skillmd.com/u/chainlesschain)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/chainlesschain/memory-insights

---


# Memory Insights Skill

Knowledge base analytics and health monitoring for the Permanent Memory system.

## Usage

```
/memory-insights [action] [options]
```

## Actions

| Action   | Command                      | Description                                             |
| -------- | ---------------------------- | ------------------------------------------------------- |
| Overview | `--overview`                 | File counts, total size, type distribution, dates       |
| Health   | `--health`                   | Health score (0-100) with issue breakdown               |
| Keywords | `--keywords [--top <n>]`     | Top keywords by frequency (stop-word filtered)          |
| Trends   | `--trends`                   | Weekly file creation/modification over last 30 days     |
| Gaps     | `--gaps`                     | Topics mentioned frequently but lacking dedicated files |
| Report   | `--report [--output <file>]` | Comprehensive report combining all analyses             |

## Health Score Criteria

- **Staleness** (-5 per file not modified in 30+ days, max -25)
- **Empty Files** (-10 per empty file, max -30)
- **Directory Completeness** (-10 per missing expected directory)
- **File Count** (-15 if fewer than 3 files)
- **Recent Activity** (+10 bonus if files modified in the last 7 days)

## Directories Scanned

- `.chainlesschain/memory/` - Long-term memory files (MEMORY.md, sections)
- `.chainlesschain/memory/daily/` - Daily note logs (YYYY-MM-DD.md)