AgentSkillsCN

soul-update

更新助手的持久化Markdown身份文件：SOUL.md（性格档案）、IDENTITY.md（姓名与角色）、USER.md（用户资料），或MEMORY.md（长期记忆）。支持追加内容或完全替换文件两种模式。

SKILL.md
--- frontmatter
name: soul-update
description: >
  Update one of the assistant's persistent markdown identity files: SOUL.md (personality),
  IDENTITY.md (name and role), USER.md (user profile), or MEMORY.md (long-term memory).
  Supports append (add content) or replace (overwrite entire file) modes.
license: Apache-2.0
compatibility: Requires filesystem access
metadata:
  tier: builtin
  mutating: "true"
  confirmation-required: "false"
  params: '{"target": {"type": "string", "description": "File to update: soul, identity, user, or memory"}, "content": {"type": "string", "description": "Content to write"}, "mode": {"type": "string", "description": "Write mode: append (default) or replace"}}'

Instructions

Update one of the assistant's persistent memory markdown files.

Parameters

  • •target (string, required): Which file to update — one of: soul, identity, user, memory
  • •content (string, required): The text to write
  • •mode (string, optional): append (default) adds content to the end; replace overwrites the entire file

Target files

targetFilePurpose
soul~/.assistant/SOUL.mdCore personality, values, and behavioral truths
identity~/.assistant/IDENTITY.mdName, role, goals — the agent's structured identity
user~/.assistant/USER.mdUser profile: name, timezone, preferences
memory~/.assistant/MEMORY.mdCurated long-term memory — important facts

Behavior

  • •append mode: adds \n<content> to the end of the file (creates if not exists)
  • •replace mode: completely replaces the file with content
  • •Confirms the update with the path that was written

When to use

  • •When the user updates their profile (name, timezone, preferences) → update user
  • •When you learn something important to remember permanently → update memory
  • •When the user adjusts your personality or behavior → update soul
  • •After a significant project completes and context should persist → update memory

Example interactions

  • •"My name is Alice and I'm in Berlin timezone" → target: "user", mode: "append", content: "## User\n- Name: Alice\n- Timezone: Europe/Berlin"
  • •"Always use metric units" → target: "soul", mode: "append", content: "\n- Use metric units in all responses"