← Back to Skills Marketplace
118
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install soul-search
Description
Browse categories, preview, apply, and restore OpenClaw SOUL.md personas from a curated remote catalog. Use for /soul categories, /soul list <category>, /sou...
Usage Guidance
This skill appears coherent and implements the described /soul commands. Before installing: ensure you trust the configured catalog URL (default is mergisi/awesome-openclaw-agents) and any remote SOUL.md sources it references, because the skill will fetch and apply those files; it will create backups and a state file under soul-data/ in your current workspace and requires the node binary. If you want to be extra safe, review the catalog entries (agents.json) and the specific SOUL.md sources you expect to apply; the script prevents local paths from escaping the workspace but will read any SOUL.md that the catalog points to (remote or local within workspace).
Capability Analysis
Type: OpenClaw Skill
Name: soul-search
Version: 1.0.0
The 'soul-search' skill is a persona management tool for OpenClaw that allows users to browse and apply 'SOUL.md' system prompts from a curated GitHub repository. The implementation in 'scripts/soul.mjs' follows security best practices, including path traversal protection to prevent workspace escapes, automated backups before overwriting files, and checksum validation to detect manual edits. The code uses only built-in Node.js modules and lacks any indicators of data exfiltration or malicious intent.
Capability Assessment
Purpose & Capability
Name/description ask for browsing, previewing, applying, and restoring SOUL.md personas. The skill only requires node, reads/writes SOUL.md and soul-data/*, and fetches catalog and SOUL.md content — all necessary and proportional to the stated purpose.
Instruction Scope
SKILL.md directs the agent to run the included Node helper script and return its output. The script's runtime actions (fetch catalog, read/write SOUL.md, create backups, write state.json) are consistent with the documented commands and the skill's purpose. The script enforces workspace-path checks and documents safety rules.
Install Mechanism
There is no install spec; this is instruction+script only. No downloads or third-party package installs are requested by the skill manifest itself.
Credentials
The skill requests no environment variables or credentials. It performs network fetches against catalog and SOUL.md source URLs declared in code (defaulting to a GitHub raw URL and docs.openclaw.ai). Local file reads/writes are confined to the workspace (enforced by path checks).
Persistence & Privilege
The skill is not marked always:true and does not modify other skills or global agent configuration. It stores backups and state only under workspace/soul-data/, which matches its function.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install soul-search - After installation, invoke the skill by name or use
/soul-search - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of soul-search skill.
- Enables browsing, previewing, applying, and restoring OpenClaw SOUL.md personas from a curated remote catalog.
- Supports commands: categories, list, show, apply, current, restore, refresh, and search.
- Invocations run a Node.js script and directly return its output to the user.
- Safety measures include catalog trust, persona backups, and metadata recording.
- Reminds users to start a new session for changes to take effect after apply/restore actions.
Metadata
Frequently Asked Questions
What is Soul Search?
Browse categories, preview, apply, and restore OpenClaw SOUL.md personas from a curated remote catalog. Use for /soul categories, /soul list <category>, /sou... It is an AI Agent Skill for Claude Code / OpenClaw, with 118 downloads so far.
How do I install Soul Search?
Run "/install soul-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Soul Search free?
Yes, Soul Search is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Soul Search support?
Soul Search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Soul Search?
It is built and maintained by ALB.Leach (@alexleach); the current version is v1.0.0.
More Skills