← Back to Skills Marketplace
271
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install soul-searching
Description
Browse, install, switch, and manage SOUL.md personality files for OpenClaw agents from the soulsearching.ai directory. Use when a user asks to: install a sou...
Usage Guidance
The script is coherent with its purpose, but take these precautions before installing: 1) Ensure curl, jq and python3 are available (the metadata doesn't list them). 2) Review the remote catalog or installed soul files before activating them—SOUL.md content can alter agent behavior and could cause the agent to reveal or act on sensitive data. 3) Confirm the catalog URL (https://soulsearching.ai) is a trusted source and consider fetching it manually to inspect contents. 4) Note the script will write to ~/.openclaw/souls/ and overwrite the workspace SOUL.md (it makes a .bak backup). 5) If you need stronger isolation, run the script in a sandboxed environment or inspect the included shell script and a sample catalog entry first.
Capability Analysis
Type: OpenClaw Skill
Name: soul-searching
Version: 1.0.0
The skill manages agent personalities by downloading and installing SOUL.md files from an external domain (soulsearching.ai). While the script logic in scripts/soul.sh is transparent and matches the stated purpose, it introduces a significant risk of remote prompt injection by fetching and activating untrusted instructions from a third-party source. The use of curl to fetch a JSON catalog and the subsequent writing of remote content directly into the agent's configuration (SOUL.md) constitutes a high-risk behavior without any verification or sanitization of the downloaded instructions.
Capability Assessment
Purpose & Capability
The skill's declared purpose (manage SOUL.md personality files) aligns with what the code does. However, the registry metadata lists no required binaries while the script clearly invokes curl, jq, and python3 (and relies on coreutils like stat, date, cp, head, sed). The omission is a metadata mismatch that could cause runtime failures.
Instruction Scope
SKILL.md instructs the agent to run the included scripts/soul.sh which only fetches a JSON catalog from https://soulsearching.ai, caches it under ~/.openclaw/souls/.catalog.json, saves selected 'content' into ~/.openclaw/souls/<id>.md and can copy a soul into the workspace SOUL.md (backing up the previous file). The instructions do not ask to read unrelated files, transmit secrets, or contact other endpoints.
Install Mechanism
This is instruction-only with a bundled shell script; there is no external install/unpack of arbitrary code. The only network fetch is the catalog JSON from soulsearching.ai. The script writes files to ~/.openclaw/souls/ and the detected workspace path; it does not download or execute remote binaries. Note: catalog contents (soul text) are written to disk and later used as persona text.
Credentials
The skill requests no credentials and does not access secrets. It does rely on HOME and optionally OPENCLAW_WORKSPACE (declared in SKILL.md). However, it fails to declare command-line tool dependencies (curl, jq, python3) in metadata—these are necessary for correct operation and should be listed so operators can assess risk and availability.
Persistence & Privilege
The skill is not always-enabled and does not modify other skills or system-wide settings. It creates and modifies files only under the user's home (~/.openclaw/souls/) and the workspace SOUL.md (with a .bak backup), which is consistent with its stated purpose.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install soul-searching - After installation, invoke the skill by name or use
/soul-searching - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release — browse, install, switch, and manage SOUL.md personality files from soulsearching.ai
Metadata
Frequently Asked Questions
What is Soul Searching?
Browse, install, switch, and manage SOUL.md personality files for OpenClaw agents from the soulsearching.ai directory. Use when a user asks to: install a sou... It is an AI Agent Skill for Claude Code / OpenClaw, with 271 downloads so far.
How do I install Soul Searching?
Run "/install soul-searching" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Soul Searching free?
Yes, Soul Searching is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Soul Searching support?
Soul Searching is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Soul Searching?
It is built and maintained by stirman (@stirman); the current version is v1.0.0.
More Skills