My Soul Upgrade Skill

What This Skill Does

The My Soul Upgrade Skill, developed by canonxu, provides a structured framework for managing the identity and operational definitions of OpenClaw agents. By utilizing a two-layer template architecture, this skill allows users to maintain both global behavioral standards—which apply to every agent in the system—and agent-specific nuances. It effectively separates common principles from localized role-play or technical capabilities, ensuring that your agent's persona (its "Soul") is always consistent, up-to-date, and aligned with your broader system configurations.

Installation

To integrate this skill into your environment, run the following command in your terminal:

clawhub install openclaw/skills/skills/canonxu/my-soul-upgrade-skill

Ensure that you have the necessary write permissions in the /home/admin/.openclaw/ directory to allow the build script to generate and refresh the required configuration files.

Use Cases

• Maintaining Consistency: Update global safety guidelines or communication styles in one file and propagate them to every active agent instantly.
• Agent Personalization: Create specialized agents for distinct tasks (e.g., coding, creative writing, or system administration) by editing individual template.md files while keeping core system prompts identical across all of them.
• Rapid Iteration: Quickly tweak the personality or technical constraints of a specific agent without needing to manually edit multiple files or reconfigure the entire system from scratch.

Example Prompts

1. "Sync my souls after updating the global guidelines in the SOUL.md file."
2. "Update agent workspace-42 to include a more professional tone by modifying its template.md file and rebuilding."
3. "Run the build script to ensure all agent configurations are synchronized with the latest global SOUL changes."

Tips & Limitations

• Synchronization is Mandatory: The most critical aspect of this skill is the build_all_souls.py script. Any change to either the global SOUL.md or an agent-specific template.md will not take effect until you execute this script. Failing to sync can lead to mismatched behaviors where an agent uses stale identity data.
• File Structure: Adhere strictly to the paths provided. The script expects standard file locations; moving these configuration files will break the build process.
• Backup: Since this skill performs write operations on your system configuration files, it is recommended to keep backups of your primary template.md files before making complex architectural changes to your agent personas.