opensite-ai/opensite-skills / memory
memory
VerifiedThe OpenSite persistent long-term memory store. Provides a hierarchical filesystem tree for all agent memories across four cognitive layers: episodic (session history), semantic (project/tech/user knowledge), procedural (decisions, workflows, conventions), and working (active session state). Use this skill to directly read, write, search, or inspect memory entries. For automated session capture use memory-write; for context retrieval before a task use memory-recall; for periodic maintenance use memory-consolidate.
| File | Kind | Size |
|---|---|---|
| .gitignore | other | 780 B |
| README.md | markdown | 1.4 KB |
| SKILL.md | skill md | 5.2 KB |
| meta/.gitkeep | other | 0 B |
| scripts/consolidate.py | script | 7.4 KB |
| scripts/list_memories.py | script | 2.4 KB |
| scripts/search_memory.py | script | 7.6 KB |
| scripts/write_memory.py | script | 8.2 KB |
README.md
View on GitHub# memory
The core storage skill of the OpenSite long-term memory system. This skill defines
the hierarchical directory tree structure and provides the Python scripts that all
other memory skills use to read and write entries.
## What This Skill Is
This is the **schema and rulebook** — not an action skill. It defines the store layout,
entry format, tag taxonomy, and exposes low-level read/write/search operations.
The actual memory data lives in `store/` inside this directory (gitignored).
## Store Location
```
memory/
├── SKILL.md ← Skill instructions (versioned in git)
├── scripts/ ← Python utilities (versioned in git)
└── store/ ← Memory data (gitignored, lives only on your machine)
├── episodic/
├── semantic/
├── procedural/
└── working/
```
## Scripts
| Script | Purpose |
|--------|---------|
| `write_memory.py` | Atomic write with frontmatter, dedup guard, and index update |
| `search_memory.py` | Keyword + TF-IDF search across all memory layers |
| `list_memories.py` | List all entries with optional filtering |
| `consolidate.py` | Confidence decay, duplicate detection, session compression |
No external dependencies. Python 3.8+ only.
`write_memory.py` accepts inline content via `--content`, but for multiline markdown,
code fences, or shell-sensitive text you should prefer `--content-stdin` or
`--content-file`.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |