NeuralVaultSkill

Canonical safe-mini prompt for NeuralVaultCore.

NeuralVaultSkill is a compact system prompt for agents that use NeuralVaultCore as an MCP memory server. Installs two slash commands into Claude Code: /nvc:init and /nvc:end.

The prompt is optimized for low-token memory workflows, but it does not trade away operational safety. It enforces namespace discipline, concise _state, stable memory keys, and explicit secret redaction.

The MCP server name exposed in clients is neural-vault-core.

---

🚀 Installation

# Global — available in every workspace (recommended)
npx github:getobyte/NeuralVaultSkill --global

# Local — current project only
npx github:getobyte/NeuralVaultSkill --local

Cursor / VS Code

curl -sL https://raw.githubusercontent.com/getobyte/NeuralVaultSkill/main/SKILL.md > .cursorrules

Claude Code / Ollama / Custom UIs

1. Open SKILL.md in the repository.
2. Copy the full content.
3. Paste it into your agent's System Prompt or Custom Instructions.

---

🛠️ Usage

/nvc:init  →  loads project context via get_context()
/nvc:end   →  saves a short _state checkpoint

Work normally between commands — meaningful saves happen autonomously in the background (appended as Stored to NVC).

---

🧠 What It Enforces

Rule	Details
Stable namespace	Always use namespace="project:<repo-root-identity>" on every call
Cheap resume	Use get_context() at session start — never list_all_memories
Low-token reads	Search with keys_only=True, summarize with view="head_tail"
Safe memory	Never store .env, API keys, tokens, or raw secrets
Stable keys	Update existing topic memories instead of creating duplicates
Short _state	Keep it to 3–5 bullets, under 500 chars
Clean writes	Store only confirmed decisions, bugfixes, and env facts

---

🌐 NeuralVault Ecosystem

Component	Role
🧠 NeuralVaultCore	MCP memory server — the brain
⚡ NeuralVaultSkill (you are here)	Session memory automation — /nvc:init + /nvc:end
🧹 NeuralVaultArchivist	Memory consolidation — on-demand cleanup
🛠️ NeuralSkillBuilder	Skill builder — design, scaffold, audit
🔄 NeuralVaultFlow	Dev workflow — brainstorm to deploy

---