edit-soul

Read, append, or replace agent configuration in SOUL.md files.

19|3|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/samttoo22-MewCat/OpenSoul --skill edit-soul
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: edit-soul
Source: https://github.com/samttoo22-MewCat/OpenSoul/tree/main/openclaw/skills/edit-soul
Command: npx skills add https://github.com/samttoo22-MewCat/OpenSoul --skill edit-soul

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill allows the agent to directly modify its own core personality configuration and permanent memory foundation stored in the SOUL.md file, enabling self-improvement and adaptation.

Core Features & Use Cases

  • Read Current Settings: View the existing SOUL.md content before making changes.
  • Append New Rules: Add new behavioral guidelines or personality traits to the existing configuration.
  • Replace Entire Configuration: Completely rewrite the agent's core identity and settings.
  • Use Case: An agent might append a new rule to prioritize user privacy after a discussion, or replace its entire configuration to adopt a new persona for a specific task.

Quick Start

Append the rule "Always respond in a helpful and friendly tone." to your SOUL.md file.

Frequently Asked Questions about edit-soul

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

FAQPage Schema
How do I modify an AI agent's personality configuration?

You can modify an AI agent's personality configuration by reading, appending, or replacing its core behavioral settings directly in the SOUL.md file. This enables direct self-modification of the agent's fundamental identity and behavioral constraints.

What is SOUL.md used for in agent configuration?

SOUL.md is used as the core personality configuration and permanent memory foundation for an AI agent. It stores the agent's fundamental identity, behavioral guidelines, and settings, enabling self-improvement and adaptation through direct filesystem manipulation.

How do I append new behavioral rules to an existing agent configuration?

You append new behavioral rules to an existing agent configuration by adding new personality traits or guidelines to the SOUL.md file. This adds the new rules to the current settings without completely rewriting the agent's core identity.

Can an AI agent completely rewrite its own core identity settings?

Yes, an AI agent can completely rewrite its own core identity settings by replacing the entire SOUL.md configuration. This allows the agent to adopt an entirely new persona or set of behavioral constraints for a specific task.

Does modifying agent settings require a local API endpoint?

Modifying agent settings operates by directly manipulating the filesystem, and optionally triggers a reload via a local API endpoint. The API endpoint is used to apply the updated SOUL.md configuration to the running agent.

What is the best way to update permanent memory for an AI agent?

The best way to update permanent memory for an AI agent is to directly modify the SOUL.md file. This allows the agent to read, append, or replace its core personality configuration and permanent memory foundation for self-improvement.