memory-consolidation
Skill142 starsChanged 3 months agoApache-2.0View on GitHub
Keep the memory inside its size limits by compacting rather than truncating, so it stays readable as it ages.
5 other projects use a version of this.
Adopted by
Most recently taken up by
- ArttuAn/agent-memory-skillstheir own version, first seen Oct 25, 2026
- modimihir07/agentic-ostheir own version, first seen Oct 25, 2026
- ManceRayder42/jarvis-ostheir own version, first seen Oct 1, 2026
- NITISH-R-G/agent-memory-protocoltheir own version, first seen Aug 1, 2026
- zwjbendn/weight-loss-skilltheir own version, first seen Mar 16, 2026
Other versions5 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 5
- modimihir07/agentic-os★ 209same name
- ManceRayder42/jarvis-os★ 5same name
- ArttuAn/agent-memory-skills★ 2same name
- NITISH-R-G/agent-memory-protocol★ 1same name
- zwjbendn/weight-loss-skill★ 1same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository62 other files it gives its agents.
- examples/recipes/partners/hpe/retail-assistant/docker-compose/scripts/identity/AGENTS.mdAGENTS.md
- examples/recipes/partners/hpe/retail-assistant/helm/files/identity/AGENTS.mdAGENTS.md
- examples/recipes/partners/tavily/watchtower/prompts/AGENTS.mdAGENTS.md
- nemoclaw-community-contributor-examplesSkill
- nemoclaw-community-maintainer-policiesSkill
- coach-nemoclaw-hermesSkill
- coordinate-nemoclaw-blenderSkill
- blender-host-sandbox-boundarySkill
- blender-python-api-verificationSkill
- ovphysx-host-runtime-boundarySkill
- axe-a11ySkill
- deep-researchSkill
- cross-source-gap-analysisSkill
- github-readonly-liveSkill
- nemoclaw-autohealSkill
- nemoclaw-nvteamSkill
- outlook-email-searchSkill
- slack-channel-finderSkill
- slack-channel-summarizerSkill
- source-etl-querySkill
- module-1Skill
- module-2Skill
- module-3Skill
- module-4Skill
- module-5Skill
- module-6Skill
- module-7Skill
- setup-workshop-nemoclaw-operatorSkill
- setup-workshop-nemoclawSkill
- workshopSkill
- cross-source-gap-analysisSkill
- github-readonly-liveSkill
- gitlab-readonly-liveSkill
- nemoclaw-autohealSkill
- nemoclaw-nvteamSkill
- outlook-email-searchSkill
- public-web-searchSkill
- slack-channel-finderSkill
- slack-channel-summarizerSkill
- source-etl-querySkill
- kubernetes-sreSkill
- openshift-llm-deploySkill
- inbound-judgingSkill
- memory-repairSkill
- memory-writingSkill
- obligation-reviewSkill
- preference-updateSkill
- nv-tech-assistantSkill
- payment-ops-playbookSkill
- payment-screeningSkill
- rail-boundary-testSkill
- release-packetSkill
- pr-reviewSkill
- pr-test-case-assistantSkill
- vss-videoSkill
- nemoclaw-hermes-swarmSkill
- blackwall-payment-gateSkill
- retail-apiSkill
- retail-apiSkill
- watchtowerSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
9 rules. 0 are common, 4 are distinctive, and 5 are very specific to this project.
0
Common
Most of the 5 edited versions we read keep these.
4
Distinctive
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 15
All reads of workspace/memory use python3 $HERMES_HOME/scripts/memory_operations.py read <relative-path> ....
- Distinctive: line 18
If it reports a pending or blocked operation, stop this pass and surface the diagnostic.
- Very specific: line 21
All memory file changes, including shared index entries and the single log entry, go through python3 $HERMES_HOME/scripts/apply_memory.py < …
- Very specific: line 23
Never write, append, rename, or delete memory files with shell or file tools.
- Very specific: line 26
Use null text for a reviewed people merge source deletion and include its index removal in the same operation.
- Very specific: line 36
Before building a proposal, read $HERMES_HOME/scripts/memory-protocol.md for the installed JSON contract and examples.
- Distinctive: line 52
Read the schema's growth-control table first.
- Distinctive: line 74
Provenance on every claim that survives: If you keep the claim, keep its footnote.
- Distinctive: line 86
If a page needs judgment you cannot make safely — two entries that might be the same project, a commitment you cannot tell is resolved — …
“Common” is measured: kept by at least 6 in 10 of the 5 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Coordinated memory transport
All reads of workspace/memory use
python3 $HERMES_HOME/scripts/memory_operations.py read <relative-path> ....
This returns the store instance, exact file hashes, and a coherent snapshot.
If it reports a pending or blocked operation, stop this pass and surface the
diagnostic. Do not read partial files as current memory.
All memory file changes, including shared index entries and the single log
entry, go through python3 $HERMES_HOME/scripts/apply_memory.py < proposal.json.
Never write, append, rename, or delete memory files with shell or file tools.
Prepare complete people/attention pages and their evidence markers together
in a legacy_write proposal with the returned expected_hash for every file.
Use null text for a reviewed people merge source deletion and include its
index removal in the same operation. Preserve the content and admission rules
below. A failed proposal acknowledges no new evidence batch.
Managed projects, patterns, and concepts use update with declared field
changes; never send a managed page through the whole-file adapter. Existing
unmanaged pages may be repaired with their exact full-file precondition and
remain unmanaged. Use repair_index for verified missing or stale entries,
and log_only for a pass that changes only the shared memory log. The writer
constructs index patches and a log entry containing its operation ID.
Before building a proposal, read $HERMES_HOME/scripts/memory-protocol.md
for the installed JSON contract and examples.
A conflict preserves the live file. Report it and defer that target. Generate
a fresh independent proposal for unrelated work; do not retry a changed
request under an already used request ID, adopt a page implicitly, clear
review flags, or use a direct write as a fallback. Per-page user approval is
not required for generated content after Foundation enablement. Handwritten
content requires an explicit scoped user action through correct.py.
Consolidating the memory
Memory that only grows stops being read, and a memory nobody reads is worse
than none — it looks like the system knows things it can no longer surface.
This job keeps pages inside the ceilings in $HERMES_HOME/schema.md.
Read the schema's growth-control table first. Work only on pages the repair job reported as over their ceiling, or that you can see are over.
Compact, do not truncate
The distinction is the whole job.
- Dated events move, they do not vanish. A project's dated bullets belong
in that project's
log.md; the main page keeps the current picture. - Superseded state is dropped. "Waiting on the vendor to reply" is dead once the vendor replied. That is not information loss, it is the page catching up.
- A person's Recent Interactions past 30 items become a
Relationship Arc: a few sentences on how the working relationship changed. Write it once, revise it later, never append to it. - Patterns decay. A behaviour last observed months ago and never since is weakened or dropped, not restated with confidence it no longer has.
What must survive
- Unresolved commitments. Anything the user owes someone, or is owed, survives compaction regardless of age. Age is not resolution.
- Provenance on every claim that survives. If you keep the claim, keep its footnote. A compacted page full of unsourced assertions is worse than the long one it replaced.
- Project history. Moved to
log.md, never deleted. Rotate the log at its limit rather than trimming it.
Bounded work
Compact the pages that are over, and stop. Rewriting the whole memory because two pages were long is how a maintenance job turns into an outage — and every rewrite is an opportunity to lose a footnote.
If a page needs judgment you cannot make safely — two entries that might be the same project, a commitment you cannot tell is resolved — leave it and say so in the log. An honest deferral is a good outcome.
Log
## [2026-08-18T09:31:00Z] consolidation
- projects/billing_migration: moved 14 dated bullets to log.md, page now 4 sections
- people/dana_okoro: Recent Interactions 41 -> 30, wrote Relationship Arc
- deferred: two entries under concepts/ may be the same term, evidence unclearDoes it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

