# Memory

> Split memory system with USER.md for durable personal profile and MEMORY.md for token-budgeted operational context.

- **Type:** Skill
- **Install:** `agentstack add skill-rikyz90-shibaclaw-memory`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [RikyZ90](https://agentstack.voostack.com/s/rikyz90)
- **Installs:** 0
- **Category:** [Cloud & Infrastructure](https://agentstack.voostack.com/c/cloud-infrastructure)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [RikyZ90](https://github.com/RikyZ90)
- **Source:** https://github.com/RikyZ90/ShibaClaw/tree/main/shibaclaw/skills/memory
- **Website:** https://deepwiki.com/RikyZ90/ShibaClaw

## Install

```sh
agentstack add skill-rikyz90-shibaclaw-memory
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Memory

## Structure

- `USER.md` — Durable personal profile and preferences. Not token-compacted; keep it focused on long-lived user facts.
- `memory/MEMORY.md` — Operational long-term facts. Injected into every system prompt under `# Memory`, **truncated from the bottom** if it exceeds the token budget (~2000 tokens default).
- `memory/HISTORY.md` — Append-only log with `[YYYY-MM-DD HH:MM] [#tag1 #tag2]` entries. Never injected. Search it with `memory_search` or grep when historical context is missing.

## MEMORY.md Layout

Sections are ordered by **survival priority** — top sections persist under truncation, bottom sections are dropped first.

1. `## Environment` — OS, runtime, tooling constraints, local services, provider setup
2. `## Entities` — people, projects, repos, services referenced often
3. `## Project State` — milestones, blockers, medium-term status, important decisions
4. `## Dynamic Context` — current tasks, recent decisions, in-progress work

**Rules:**
- One fact per bullet, no prose paragraphs
- **Update/replace** existing facts instead of appending duplicates
- Put personal profile and preferences in `USER.md`, not in `memory/MEMORY.md`
- Put durable operational facts in the top three MEMORY sections; only transient state goes in Dynamic Context
- Keep the file concise — the system auto-compacts when it exceeds ~1600 tokens

## Missing Context

If a topic feels incomplete, **search `HISTORY.md` first** before assuming a fact was never recorded. Use the `memory_search` tool for semantic queries, or grep for exact matches:

```bash
grep -i "keyword" memory/HISTORY.md
```

## Proactive Context Retrieval

If the user refers to past discussions or ongoing workflows you don't recall: **search `HISTORY.md` before responding**.

## Auto-consolidation

Handled automatically every ~10 messages. Long-term memory is auto-compacted by the system when it grows beyond the configured threshold.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [RikyZ90](https://github.com/RikyZ90)
- **Source:** [RikyZ90/ShibaClaw](https://github.com/RikyZ90/ShibaClaw)
- **License:** Apache-2.0
- **Homepage:** https://deepwiki.com/RikyZ90/ShibaClaw

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-rikyz90-shibaclaw-memory
- Seller: https://agentstack.voostack.com/s/rikyz90
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.