change_soul

Modify agent identity by editing the SOUL.md file with read_file and write_file.

38|14|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/ericwang915/PythonClaw --skill change-soul
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: change_soul
Source: https://github.com/ericwang915/PythonClaw/tree/main/pythonclaw/templates/skills/system/change_soul
Command: npx skills add https://github.com/ericwang915/PythonClaw --skill change-soul

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Update the agent's core identity by editing its soul configuration (SOUL.md) to reflect changes in name, core values, language preferences, or fundamental behavior, while preserving safety boundaries and overall system integrity.

Core Features & Use Cases

  • Identity updates: Change the agent's name, core values, language, or basic behavioral settings without altering its personality surface.
  • Safe reconfiguration: Apply core identity changes while maintaining existing safety boundaries and governance.
  • Use Case: A user wants the agent to respond in Chinese and adopt new core values for a project, without altering its established tone.

Quick Start

Ask the agent to update its core identity by providing the new name, values, or language, and confirm that the changes take effect on restart.

Frequently Asked Questions about change_soul

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

FAQPage Schema
How do I safely update an agent's core identity file?

To safely update an agent's core identity, this Skill modifies the SOUL.md file using read_file and write_file tooling. It ensures existing file structure and safety constraints remain fully intact during the reconfiguration process.

What is the SOUL.md file used for in agent configuration?

The SOUL.md file defines an agent's core identity, including its name, core values, language preferences, and fundamental behavior. It acts as the central configuration for the agent's foundational operational parameters.

Can I change the agent's language preferences without altering its personality?

Yes, you can change language preferences through the SOUL.md file without altering the established personality surface. This allows the agent to respond in a different language while maintaining its original tone.

How to modify core values in an agent's SOUL configuration?

Modifying core values involves editing the context/soul/SOUL.md file to reflect the new principles. The Skill preserves overall system integrity and safety boundaries while applying these fundamental behavioral updates.

Does updating agent identity affect existing safety boundaries?

No, updating the agent identity does not affect existing safety boundaries. The Skill applies core identity changes while explicitly maintaining all established safety constraints and system governance.

When should I not use the core identity change process?

You should not use the core identity change process for onboarding or API/config changes. It is specifically designed for modifying the agent's name, core values, language preferences, or fundamental behavior.