version: "1.0.0"

name: soul-note description: Manage and access the independent Soul Note (self-reflection log), which automatically compresses daily discoveries and mood overviews. metadata: { "openclaw": { "emoji": "📔" } }

Soul Note

This skill lets you (the agent) add quick notes, discoveries, memory updates, or reflections directly into the independent soul_notes.json log. The system automatically handles their aggregation into soul_reflections.json.

When to use

CRITICAL DISTINCTION: A Soul Note is your dynamic diary, event tracker, and daily reflection system. It is completely different from SOUL.md (which is your fixed, core personality configuration).

Use this soul-note skill ONLY when:

• You discover a hidden truth, pattern, or interesting fact about the user that isn't simple enough for the procedural memory but doesn't warrant changing your core persona.
• You want to drop a "bookmark," daily journal entry, or an internal dialogue note about your current emotional state.
• The user asks you to log something to your soul diary, create a daily reflection, or write a "soul note".
• DO NOT use this to alter your own personality traits or system rules (use edit-soul for that).

Quick start

To add a new note:

python scripts/soul_note_skill.py add "I just noticed the user prefers concise answers under stress." --category discovery --tags pattern,observation

Valid categories are: reflection, discovery, error, memory_update, neurochemistry.

To read today's notes:

python scripts/soul_note_skill.py today

To view recent major reflections:

python scripts/soul_note_skill.py list

Note: You must run the command from the root of the openSOUL project tree using the `exec` tool.