# Save

> Save session context to the NEO second brain. Spawns neo-shadow to update .neo/brain/ files (ACTIVE, PROGRESS, DECISIONS, LESSONS) from the session delta. Use at task boundaries, before ending a session, before compaction, or whenever the user says "save context" or "update the brain".

- Skill: `vidit19sharma/save` (Agent Skill)
- Install (CLI): `npx skillmds@latest add vidit19sharma/save`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vidit19sharma/save/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: vidit19sharma (https://skillmd.com/u/vidit19sharma)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vidit19sharma/save

---


# /neo:save — persist session memory

Brain: !`ls .neo/brain 2>/dev/null || echo "MISSING — run /neo:init first"` · Uncommitted: !`git diff --stat HEAD 2>/dev/null | tail -1 || echo "not a git repo"`

## Steps

1. **Guard**: if `.neo/brain/` is missing, stop and point to `/neo:init`.

2. **Assemble the session delta** (you, NEO, know the session — the shadow doesn't):
   - What was worked on and what state it reached (done / in-flight / blocked)
   - What changed on disk (summarize from the git stat above; include key file paths)
   - Decisions made this session, with the why and the rejected alternatives
   - Anything that bit us — mistakes, surprises, gotchas worth a lesson
   - What comes next + open questions

3. **Spawn neo-shadow** (Agent tool) with the 6-section contract. TASK: update the brain from this delta. EXPECTED OUTCOME: ACTIVE rewritten (cap 150 lines), PROGRESS appended under today's date, DECISIONS/LESSONS updated only if the delta earns it, ARCHITECTURE only if patterns changed, WORKFLOWS updated if the session repeated a known multi-step sequence. MUST NOT: touch anything outside `.neo/`. CONTEXT: the full delta from step 2.

4. **Verify**: confirm from the shadow's report which files changed. Relay one line to the user: "Brain saved — ACTIVE rewritten, PROGRESS +1 entry" (adjust to reality). If the report flags a workflow at 3+ sightings, offer `/neo:train`.