Context Engine

Maintains and restores project context across sessions, tracks active projects, manages tasks, switches projects, and summarizes current progress.

MIT-0 · Free to use, modify, and redistribute. No attribution required.
0 · 156 · 0 current installs · 0 all-time installs
MIT-0
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Suspicious
medium confidence
Purpose & Capability
Name/description (manage project context across sessions) aligns with the included implementation: a Node CLI that reads/writes project/session JSON files and provides commands for save/restore/summarize/switch. However, the registry metadata declares no required config paths while SKILL.md and the code explicitly use a storage directory (/home/deus/.openclaw/workspace/memory/projects/), which is an inconsistency worth noting.
Instruction Scope
SKILL.md stays within scope (save/restore/summarize/switch projects) and documents where data is stored. It does instruct the agent to update long-term memory but gives no external endpoints. The instructions and code reference reading/writing local JSON files in the user's home directory — expected for this purpose but not declared in the manifest.
!
Install Mechanism
There is no install spec (instruction-only), but a Node script (scripts/context-engine.js) is included and SKILL.md shows CLI usage via 'node context-engine.js'. The manifest declared no required binaries; that is inconsistent — the skill effectively requires a Node runtime to operate. That mismatch increases risk because the runtime dependency is not declared.
!
Credentials
The skill requests no environment variables or credentials (which is appropriate), but the implementation hardcodes an absolute path in /home/deus. Hardcoding a specific home directory is brittle and unexpected (and could behave oddly if run under a different user). The code writes and may create files there without the manifest declaring required config paths or storage access — an unexplained footprint.
Persistence & Privilege
always is false and the skill does not request elevated platform privileges. Its persistence is limited to creating/updating files under the specified projects directory. It does not modify other skills' configs or declare autonomous always-on privileges.
What to consider before installing
This skill appears to implement a local project/context manager and does not show network calls or secret exfiltration in the visible code, but there are a few inconsistencies you should address before installing: - The package includes a Node CLI (scripts/context-engine.js) and SKILL.md shows 'node context-engine.js' usage, yet the manifest lists no required binaries. Verify you will run it with a trusted Node runtime and that the platform requirement is acceptable. - The code and SKILL.md hardcode /home/deus/.openclaw/workspace/memory/projects/ as the storage path. If your account is not 'deus' this will either fail or create files at an unexpected absolute path. Consider editing the script to use a relative or configurable path (e.g., process.env.HOME or a skill config) before use. - The skill writes JSON files (projects.json, session.json) and will create them if missing. Review file permissions and ownership after running to ensure no unintended data exposure. - The provided script was truncated in the package listing; inspect the entire scripts/context-engine.js file locally to confirm the unseen portion does not perform network requests, spawn arbitrary child processes, or access other system locations. If you trust the author and you or your admin can (a) run the script under an appropriate user, (b) change the hardcoded path to a safe configurable path, and (c) confirm the remainder of the script has no unexpected behavior, the skill is reasonable to use. If you cannot review or change the code, consider running it in a sandbox or rejecting installation.

Like a lobster shell, security has layers — review code before you run it.

Current versionv1.0.0
Download zip
latestvk97d7bpdnzh57t0bm8wmtfgbp582d9e1

License

MIT-0
Free to use, modify, and redistribute. No attribution required.

SKILL.md

Context Engine

Smart Context Engine maintains conversation state and project continuity across OpenClaw sessions.

Quick Start

The context engine automatically:

  • Restores your last active project on session start
  • Saves context periodically (heartbeat) and on session end
  • Tracks pending tasks and notes per project

Commands

  • "remember" / "save context" - Manually save current context
  • "switch to [project]" - Switch to a project (creates if doesn't exist)
  • "show projects" / "what are we working on" - List all projects
  • "summarize" / "where did we leave off" - Get project summary

Storage

Projects are stored in: /home/deus/.openclaw/workspace/memory/projects/

  • projects.json - All project data
  • session.json - Current session state

Actions

save_context

Saves the current context including:

  • Last topic discussed
  • Last file worked on
  • Last command executed
  • Pending tasks
  • Notes

Trigger: Explicit mention ("remember", "save context"), session_end, heartbeat

restore_context

Restores the previous session's context:

  • Loads last active project
  • Shows "Welcome back to [project]"
  • Lists pending tasks if any

Trigger: session_start, explicit request

switch_project

Switches between projects:

  • Saves current project context
  • Loads or creates new project
  • Sets as active

Trigger: Explicit mention ("switch to X")

list_projects

Lists all projects with status indicators:

  • Shows active project highlighted
  • Displays status (active/paused/completed/archived)
  • Shows last session date

Trigger: Explicit mention ("show projects", "what are we working on")

summarize

Generates a summary of the active project:

  • Current status
  • Pending tasks
  • Last topic
  • Session history

Trigger: Explicit mention ("summarize", "where did we leave off")

Triggers

TriggerConditionPriority
session_startNew session begins1
explicit_mentionUser says "remember", "save context", "project", "switch to", "show projects", "summarize"2
heartbeatEvery ~30 min when enabled3

Integration

Works with the MEMORY.md system - updates long-term memory with project summaries.

Files

4 total
Select a file
Select a file to preview.

Comments

Loading comments…