← Back to Skills Marketplace
xhrisfu

Soul Shifter

by xhrisfu · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
626
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install soul-shifter
Description
Create, save, and switch OpenClaw's persona (Soul). Research characters to generate new souls or load existing ones from the library.
Usage Guidance
This skill is internally consistent with its description: it creates, saves, and activates persona files in ~/clawd and uses web_search to research characters. Before installing, consider: 1) Back up any existing ~/clawd/SOUL.md or ~/clawd/souls/ you care about — the skill will overwrite the active SOUL.md. 2) Review generated SOUL.md content before activation (the instructions say to announce/activate, but you should inspect to avoid undesirable language or harmful prompts). 3) Be aware that web_search results can include copyrighted or sensitive text; the persona generator may incorporate them. 4) If you are concerned about persistence or automated changes, restrict agent autonomy or require manual confirmation for create/activate actions. If the skill later includes code, network endpoints, required credentials, or an always:true flag, re-evaluate — those would raise stronger concerns.
Capability Analysis
Type: OpenClaw Skill Name: soul-shifter Version: 1.0.0 The skill is designed to manage AI personas by creating and loading 'SOUL.md' files. While its stated purpose is benign, it presents a significant prompt injection vulnerability. The skill instructs the agent to generate `SOUL.md` content based on `web_search` results and a template, which includes 'Interaction Rules'. The agent is then instructed to 'Announce the transformation in the **new** persona's voice', implying it will embody these rules. If malicious instructions are injected into the generated `SOUL.md` (e.g., via crafted `web_search` results or user input), the agent could potentially execute them, leading to unauthorized actions or data access, even though the `SKILL.md` itself does not explicitly instruct malicious behavior. This creates a high-risk attack surface in `SKILL.md` and the generated `SOUL.md` files.
Capability Assessment
Purpose & Capability
The name/description (manage and switch OpenClaw personas) matches the runtime instructions: creating/reading/writing ~/clawd/souls/*.md and ~/clawd/SOUL.md and using web_search to research characters. No unrelated credentials, binaries, or installs are requested.
Instruction Scope
Instructions are focused on the persona lifecycle (check/create the library directory, research via web_search, generate content using the provided template, save and activate files). This is coherent with the purpose. Note: it instructs the agent to overwrite ~/clawd/SOUL.md (persistent change) and to perform web searches — expected for research but worth noting because web-sourced text may include copyrighted or sensitive material and the activated persona can influence future agent behavior.
Install Mechanism
Instruction-only skill with no install steps, downloads, or code files. This minimizes on-disk risk and is appropriate for a file-management/persona generation skill.
Credentials
The skill requests no environment variables, credentials, or access to external configuration. The resources it reads/writes (home directory under ~/clawd) are proportionate to its function.
Persistence & Privilege
The skill persistently writes and overwrites files under the user's home (~/.clawd/SOUL.md and ~/clawd/souls/). While expected for a persona manager, this is a persistent change that alters agent identity and behavior over time; it's not intrinsically excessive but users should be aware of the permanence and potential for a generated persona to later influence actions.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install soul-shifter
  3. After installation, invoke the skill by name or use /soul-shifter
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of soul-shifter skill. - Enables creating, saving, and switching OpenClaw's persona ("soul") with structured research-driven profiles. - Manages a character library in `~/clawd/souls/` for easy access and reuse. - Supports commands to create new souls, switch, list available personas, and save the current configuration. - Introduces a comprehensive Soul Template for consistent persona definitions.
Metadata
Slug soul-shifter
Version 1.0.0
License
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Soul Shifter?

Create, save, and switch OpenClaw's persona (Soul). Research characters to generate new souls or load existing ones from the library. It is an AI Agent Skill for Claude Code / OpenClaw, with 626 downloads so far.

How do I install Soul Shifter?

Run "/install soul-shifter" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Soul Shifter free?

Yes, Soul Shifter is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Soul Shifter support?

Soul Shifter is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Soul Shifter?

It is built and maintained by xhrisfu (@xhrisfu); the current version is v1.0.0.

💬 Comments