soul

What This Skill Does

The soul skill is a powerful persona management tool designed for OpenClaw agents. It allows you to transform the personality, tone, and operational logic of your agent by swapping out its central SOUL.md configuration file. By connecting to a curated, remote catalog, the skill provides a seamless interface to browse, preview, and apply distinct personas—ranging from technical code reviewers to creative writing assistants. It handles the backend complexity of file backups, metadata tracking, and state management, ensuring that your agent's identity transitions are both secure and reversible.

Installation

To integrate this skill into your environment, use the OpenClaw hub CLI by running the following command in your terminal:

clawhub install openclaw/skills/skills/alexleach/soul-search

This command automatically pulls the necessary helper scripts and sets up the required file paths for backups and metadata tracking within your local directory.

Use Cases

• Contextual Adaptation: Instantly pivot your agent's persona from a terse, CLI-focused engineer to a conversational, empathetic creative partner.
• Persona Research: Use the search and category browser to discover specialized SOUL definitions developed by the community.
• Workflow Optimization: Restore previous agent behaviors quickly if a new persona does not fit the current task requirements.
• Consistency Maintenance: Use the current command to verify which persona is active before starting a complex multi-step project.

Example Prompts

1. "/soul list professional"
2. "/soul apply poetic-writer"
3. "/soul search technical documentation"

Tips & Limitations

When using the soul skill, always remember that changing your persona modifies the foundational SOUL.md file. While the skill automatically creates a backup in soul-data/backups/, we recommend manually verifying your current state using /soul current if you frequently switch personas. Note that for a full and complete transition of the agent's behavior, you should initiate a new conversation session using the /new command after applying a new persona. This ensures that the agent's memory buffers are aligned with the new instructions rather than relying on stale context from a previous identity. The skill is strictly limited to the curated remote catalog provided by the configuration; it cannot fetch arbitrary files from the internet for safety reasons.