Agent skill · volcengine

openviking-memory

Work with OpenViking, the persistent context database behind this agent's memory. Use it whenever the user refers to earlier sessions or shared history ("like last time", "what did we decide"), asks to remember or forget something, shares files, URLs, or repos worth keeping, or when the task needs context this session does not have — even if nobody says the word "memory". Also use it when the user asks where memories are stored: per project, per folder, or shared between repositories. Covers choosing between context search, find, list search, and grep, reading viking:// URIs, and when (not) to write.

What it needs

About 3k tokens when loaded.

What this skill does

OpenViking Memory OpenViking stores three kinds of durable context — memories (facts, preferences, decisions), resources (imported documents, sites, repos), and skills — and serves them back across sessions. The tools may appear under a harness prefix such as mcpopenvikingfind or openvikingfind; they are the same tools. A session's lifecycle 1. Start — the OpenViking plugin has usually already injected recalled context into the conversation (look for an <openviking-context> block). Check it before searching: if it already answers the question, use it and skip the tool call. 2. During the task — when injected context is not enough, retrieve (below). Expand promising hits with read before relying on them; an abstract can be staler or thinner than its source. 3. Data in — when durable information appears, write it (below). Be deliberate: retrieval quality degrades as the store fills with noise. 4. End — the plugin captures and commits the conversation automatically, and OpenViking extracts long-term memories from it in the background. This is why you rarely need remember: anything discussed at length will be extracted anyway. Choosing a retrieval tool search with mode="context" — first choice for "what do I know about X". The server assembles a ready-to-use, token-budgeted digest across memory types; every entry carries its viking:// URI so anything that matters can be expanded with read. find — fast ranked list of memories, resources, and skills. Use it when you want raw hits to triage yourself rather than an assembled digest. search in its default list mode — deeper than find: intent analysis, optionally session-aware. Use it when find comes back thin or off-target. grep / glob — exact text or filename matching over viking:// content. Reach for these when you know the literal string, identifier, or file name; semantic search would fuzz it. read / list — expand file URIs (batch supported) / list a directory. viking:// URIs are virtual database paths, not files. …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills volcengine/openviking-memory--79c987

View the source on GitHub

Browse the @skills marketplace