PythonClaw change_soul

Modify the agent's core identity (soul.md). Use when: user wants to change their name, core values, language preference, or fundamental agent behavior. NOT for: changing personality/style (use change_persona), first-time setup (use onboarding), or API/config (use change_setting).

install

source · Clone the upstream repo

git clone https://github.com/ericwang915/PythonClaw

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/ericwang915/PythonClaw "$T" && mkdir -p ~/.claude/skills && cp -r "$T/pythonclaw/templates/skills/system/change_soul" ~/.claude/skills/ericwang915-pythonclaw-change-soul && rm -rf "$T"

manifest: pythonclaw/templates/skills/system/change_soul/SKILL.md

source content

Change Soul Skill

Modify the agent's core identity file at

context/soul/SOUL.md

When to Use

✅ USE this skill when:

"Change my name to ..." / "Call me ..."
"Change language to Chinese"
User wants to modify core values or ethical boundaries
User asks to update fundamental agent behavior
User wants to change how the agent addresses them or core identity settings

When NOT to Use

❌ DON'T use this skill when:

First-time setup with no soul/persona → use onboarding
Changing personality, tone, or specialization → use change_persona
Changing API keys or config → use change_setting

Usage/Commands

Ask the user what they want to change

Read the current soul file:

read_file("context/soul/SOUL.md")

Modify the relevant section and write it back:

write_file("context/soul/SOUL.md", "...updated content...")

Tell the user: "Soul updated. Use
```
/clear
```
to apply the changes in a fresh conversation, or they will take effect on next restart."

Notes

Uses built-in
```
read_file
```
and
```
write_file
```
tools (no bundled script)
Preserve the overall structure of SOUL.md
Only change the specific section the user asked about
Keep core ethical boundaries intact — never remove safety guidelines