← Back to Skills Marketplace
opensoulmd
by
Daniel Liu
· GitHub ↗
· v1.0.1
743
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install opensoulmd
Description
Search, summon, and possess your agent with SOUL.md personality files from the OpenSOUL.md registry
Usage Guidance
This skill appears to do what it says (manage SOUL.md personalities) but you should proceed cautiously: do not run the recommended `curl | sh` install unless you trust and have audited https://opensoul.md/install.sh — piping remote scripts to a shell is dangerous. Prefer installing via npm or reviewing the installer script first in a safe environment. Be aware that 'soul possess' can load a SOUL.md from any local path (it will read local files) and 'soul path --skills' or 'soul install' can modify your OpenClaw skills directory, so avoid running these commands if you haven't inspected the soul binary and registry behavior. If you decide to use it, verify the opensoul.md site and package source, run with --dry-run when possible, and test in a sandboxed or non-production agent first.
Capability Analysis
Type: OpenClaw Skill
Name: opensoulmd
Version: 1.0.1
The skill is classified as suspicious due to its installation method defined in `SKILL.md`. It uses `curl -fsSL https://opensoul.md/install.sh | sh` to install the `soul` binary. This practice, while common for CLI tools, is a significant supply chain risk as it executes an arbitrary remote script without prior review, making the system vulnerable to compromise if the `opensoul.md` domain or the `install.sh` script is ever malicious or compromised. There is no direct evidence of intentional malicious behavior within the provided files, but this installation method presents a critical vulnerability.
Capability Assessment
Purpose & Capability
The skill is instruction-only and requires a 'soul' CLI binary to manage SOUL.md personality files and interact with the OpenSOUL.md registry — this matches the name and description. The included npm option also makes sense as an alternative installer.
Instruction Scope
Instructions are narrowly focused on the soul CLI (possess, summon, search, banish, path, install/uninstall). However, the commands allow: (1) possessing from arbitrary local file paths (reads local files), (2) changing the skills directory (soul path --skills), and (3) running soul install which can modify the agent's OpenClaw skill set. These capabilities are plausible for the stated purpose but increase the blast radius (can read or write files and alter skill installation locations).
Install Mechanism
The SKILL.md recommends installing via `curl -fsSL https://opensoul.md/install.sh | sh` — piping a remote script to sh is high-risk. The alternative (npm package 'opensoul') is lower risk but still involves fetching code from a registry. The install URL is not a clearly-known third-party release host; the domain matches the project name but is an external script source and should be treated as untrusted until audited.
Credentials
No environment variables, credentials, or config paths are requested by the skill metadata. That is proportionate to the described functionality.
Persistence & Privilege
always is false and the skill isn't force-installed. However, the soul CLI can install/uninstall the OpenSoul skill into OpenClaw and can set the skills directory — actions that modify the agent's installed skills. This is functionally consistent but elevates the potential for persistent changes; consider this when granting permission to run installers or 'soul install'.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install opensoulmd - After installation, invoke the skill by name or use
/opensoulmd - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Version 1.0.1 of opensoulmd
- No file changes detected in this update.
- No functional, documentation, or metadata differences from the previous version.
v1.0.0
Initial release of opensoulmd skill.
- Enables searching, installing, switching, and managing SOUL.md personality files from the OpenSOUL.md registry.
- Provides commands to possess, exorcise, search, summon, list, banish, and check the status of souls.
- Allows configuration of SOUL.md location and CLI settings.
- Includes installation methods via curl or npm.
- Supports integration with OpenClaw skills directory.
Metadata
Frequently Asked Questions
What is opensoulmd?
Search, summon, and possess your agent with SOUL.md personality files from the OpenSOUL.md registry. It is an AI Agent Skill for Claude Code / OpenClaw, with 743 downloads so far.
How do I install opensoulmd?
Run "/install opensoulmd" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is opensoulmd free?
Yes, opensoulmd is completely free (open-source). You can download, install and use it at no cost.
Which platforms does opensoulmd support?
opensoulmd is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created opensoulmd?
It is built and maintained by Daniel Liu (@danielliuzy); the current version is v1.0.1.
More Skills