Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add KCNyu/clawock --skill shared-memorygit clone --depth 1 https://github.com/KCNyu/clawockWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/kcnyu/clawock/shared-memory)<a href="https://agentmods.dev/skills/kcnyu/clawock/shared-memory"><img src="https://agentmods.dev/badge/skills/kcnyu/clawock/shared-memory/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/kcnyu/clawock/shared-memory"><img src="https://agentmods.dev/badge/skills/kcnyu/clawock/shared-memory.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00046 | $0.00956 |
| Opus 5.5 | $0.00018 | $0.00382 |
| Sonnet 5.5 | $0.00009 | $0.00191 |
| Haiku 4.5 | $0.00005 | $0.00096 |
Grade A, and why
shared-memory scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 36 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Shared memory
~/.shared-memory points to one Markdown store (by default Claude Code's auto-memory directory for the home-directory project). Keep this single store and Claude Code's native auto-memory loading/writing; this skill adds cross-agent access, not another mandatory retrieval pipeline. Do not change private databases, transcripts, auto-memory settings or compaction to synchronize memory. M below is this skill's scripts/memory.py (default install: ~/.agents/skills/shared-memory/scripts/memory.py).
Layout: MEMORY.md (long-term conventions, distilled lessons-*, routes to area indexes) → indexes/MEMORY-*.md → one topic per concept, named feedback-|lessons-|decision-|project-|incident-|reference-…. archive/ holds retired topics and the full text of large topics; it is search-only. Old names resolve through indexes/redirects.tsv; new topics are routed by indexes/routes.tsv.
The store belongs to coding sessions started in the home directory and to tasks dispatched from there. A separate-memory context — an OpenClaw workspace, whose assistant keeps its own MEMORY.md — never gets this index injected and never stores these notes; wiring.json lists both kinds and scripts/memctl doctor checks them.
Recall only missing context
- If the relevant fact is already in the conversation or injected memory, use it. No index read/search is required for a self-contained task or a simple dispatch/append.
- Claude Code injects
MEMORY.md(the first 200 lines) natively in the home-directory project and through the SessionStart hook elsewhere; topic bodies are read on demand. Do not reread that index. - Other agents read
~/.shared-memory/MEMORY.mdonly when historical context is needed and not already supplied. Follow one relevant topic, not every linked lesson/index. A known topic can be read directly. - Search when the route is unknown or before repeating a past investigation:
python3 $M search 'dispatch token' --limit 3 --lines 2
What ships with it
13 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- agents/openai.yaml 228 B
- hooks/claude-hook.sh 1004 B runs code
- openclaw/index.ts 14 KB runs code
- openclaw/openclaw.plugin.json 787 B
- README.md 9.2 KB
- references/maintenance.md 6.5 KB
- scripts/memctl 43 KB
- scripts/memory.py 40 KB runs code
- systemd/shared-memory-daily.service 453 B
- systemd/shared-memory-daily.timer 166 B
- systemd/shared-memory-snapshot.service 310 B
- systemd/shared-memory-snapshot.timer 161 B
- wiring.json 1.3 KB
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 3d ago Changed 40c9dd8638f4
- 4d ago First seen · 36 lines · 46 tokens per session scan A 48bb0e99c713
shared-memory is a skill published in the GitHub repository KCNyu/clawock (21 stars, last pushed today), licensed MIT. It adds 46 tokens to every session and 956 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-10-19.
Other skills, from other repositories
awm-rsi-toolkit
Run AWM (Agent Workflow Memory, Wang et al. 2024) on an agent - induce reusable workflows from its successful trajectories, online over a training stream or offline from supplied experiences, then freeze the workflow memory and measure it on a published Benchmark.
add-compact
Add /compact command for manual context compaction. Solves context rot in long sessions by forwarding the SDK's built-in /compact slash command. Main-group or trusted sender only.
add-qmd
Add QMD (Query Markup Documents) as an advanced memory search backend. Upgrades the built-in grep-based memorysearch with hybrid BM25 + vector semantic search + LLM re-ranking. Fully local, no API keys needed. Triggers on "add qmd", "qmd memory", "semantic memory search", "upgrade memory".
obsidian-pro
Advanced Obsidian knowledge management using callouts, properties, and wikilinks. Aligned with the Gold Standard.
vault-memory
Treat the Obsidian vault as operational memory, not just note storage. Focus on retrieval quality, metadata integrity, and safe consolidation.
self-improvement
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Claude ('No, that's wrong...', 'Actually...'), (3) User requests a capability that doesn't exist, (4) An external API or tool fails, (5) Claude realizes its knowledge…