# 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).

- Skill: `ericwang915/change-soul` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ericwang915/change-soul`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ericwang915/change-soul/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: ericwang915 (https://skillmd.com/u/ericwang915)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ericwang915/change-soul

---


# 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

1. Ask the user what they want to change
2. Read the current soul file:
   ```
   read_file("context/soul/SOUL.md")
   ```
3. Modify the relevant section and write it back:
   ```
   write_file("context/soul/SOUL.md", "...updated content...")
   ```
4. 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