Skip to content

opensite-ai/opensite-skills / memory

memory

Verified

The 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.

FileKindSize
.gitignoreother780 B
README.mdmarkdown1.4 KB
SKILL.mdskill md5.2 KB
meta/.gitkeepother0 B
scripts/consolidate.pyscript7.4 KB
scripts/list_memories.pyscript2.4 KB
scripts/search_memory.pyscript7.6 KB
scripts/write_memory.pyscript8.2 KB
# 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`.
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: 471kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall