memory

Persist structured user behavior and knowledge graph data via CLI commands.

10|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/istota-project/istota --skill memory-istota-project
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: memory
Source: https://github.com/istota-project/istota/tree/main/src/istota/skills/memory
Command: npx skills add https://github.com/istota-project/istota --skill memory-istota-project

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Persist memory for user behavior (USER.md) and knowledge assets (Knowledge Graph) in a structured, auditable way, ensuring all changes pass through the memory engine instead of ad-hoc edits.

Core Features & Use Cases

  • Durable writes to USER.md for behavioral instructions and to the Knowledge Graph for factual data, enabling consistent prompts and knowledge retention.
  • Section-based memory with headings, dedup, and an audit log to track changes and support rollback.
  • Channel memory support via CHANNEL.md for shared-room context while keeping user memory isolated.
  • CLI-driven memory management with commands like append, add-heading, remove, show, and headings for predictable workflows.
  • Safe, atomic writes with locking to prevent race conditions and ensure data integrity.

Quick Start

Use istota-skill memory to add a behavioral rule under a heading, for example: istota-skill memory append --heading "Communication style" --line "Keep replies concise".

Frequently Asked Questions about memory

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I persist user behavior memory in a structured knowledge graph?

You can persist user behavior memory by using a CLI to append behavioral rules to USER.md and factual data to a knowledge graph, ensuring all updates pass through a memory engine that enforces deduplication and routing.

What is the best way to prevent race conditions when writing to a shared channel memory file?

The best way to prevent race conditions during shared channel memory updates is to use a memory engine that implements safe, atomic file writes with locking, ensuring data integrity for CHANNEL.md files across collaborative contexts.

Does this memory management approach support an audit trail for tracking changes?

Yes, this memory management approach supports an audit trail. It tracks all memory updates and supports rollback by logging changes made through CLI commands like append, add-heading, and remove, ensuring safe and auditable modifications.

How do I add a new behavioral rule under a specific section using a CLI?

You add a behavioral rule under a specific section by executing a CLI command such as `memory append --heading "Communication style" --line "Keep replies concise"`, which routes the instruction safely into the structured USER.md file.

Can I isolate user memory from shared room context when using channel memory?

Yes, you can isolate user memory from shared room context. The system maintains separate USER.md files for personal behavioral instructions and CHANNEL.md files for shared-room context, keeping user memory isolated while supporting collaborative environments.

When do I need atomic file writes for knowledge graph data?

You need atomic file writes for knowledge graph data when multiple processes or users might modify memory concurrently. This approach uses locking to prevent race conditions and ensures data integrity during structured memory updates.