| name | save-thread |
| description | Deprecated compatibility skill. In portable Agent Plugins environments this must degrade honestly to a resumable handoff, because real transcript-backed thread import is not guaranteed. Prefer save-handoff here, and use native connectors when you need actual session capture. |
Save Thread (Deprecated Compatibility)
Preserve the old skill name without pretending a generic skill runtime can always import the real session transcript.
Status
This skill name is deprecated and kept only for compatibility.
Use save-handoff for portable Agent Plugins or other generic skill environments.
Why This Cannot Promise Real Thread Save
A shared skills package works across many agent runtimes. In many of them, a skill can influence prompting but cannot read the host agent's real session transcript through a stable programmatic API.
That means this package must not promise a lossless thread import when the runtime may not expose:
- readable session files
- a transcript/history API
- a native importer surface wired for that specific agent
If we claimed real thread save here, users would believe later retrieval reflects the actual full session when it may only contain a summary.
What To Do Instead
In portable Agent Plugins environments, treat save-thread as an alias for save-handoff:
- save a concise resumable handoff with
nmem t create
- state clearly that this is a handoff summary, not a transcript-backed import
- never present the result as the full original session
When Real Thread Save Is Feasible
Use a dedicated native connector when the runtime has a real transcript importer.
Examples include Nowledge connectors such as:
In those environments, nmem t save --from <runtime> can read local session files on the client machine and upload normalized thread messages to Mem.
When To Use Which Save Surface
Use save-handoff when:
- you are in a portable Agent Plugins environment without host transcript access
- you want a restart point, checkpoint, or concise continuation summary
- the runtime does not have a proven native thread importer
Use a native save-thread only when:
- the agent has a dedicated Nowledge connector for that runtime
- real transcript import is actually implemented for that runtime
- you want the actual session captured for later search and inspection
Usage In Portable Plugin Environments
Create a structured handoff instead of pretending to save the real thread:
nmem --json t create -t "Session Handoff - <topic>" -c "Goal: ... Decisions: ... Files: ... Risks: ... Next: ..." -s generic-agent
Response Format
After successful save in a portable Agent Plugins environment:
✓ Handoff saved
Title: {title}
Summary: {content}
Thread ID: {thread_id}
Always explain that this compatibility skill creates a resumable handoff, not a real transcript import.
Native Connector
These skills work in any agent via CLI. For auto-recall, auto-capture, and graph tools, check if your agent has a native Nowledge Mem connector — run the check-integration skill or see https://mem.nowledge.co/docs/integrations
