← Back to Skills Marketplace
SOUL.md Maker
by
Jeff J Hunter
· GitHub ↗
· v1.0.5
978
Downloads
7
Stars
7
Active Installs
6
Versions
Install in OpenClaw
/install soul-md-maker
Description
SOUL.md Maker — the personality builder for OpenClaw agents. Browse 12 pre-built souls, build your own with a guided interview (Quick or Deep), blend persona...
Usage Guidance
This skill appears coherent with its stated purpose: it reads workspace file existence and writes SOUL.md files under ~/workspace/. Before installing, confirm that (1) you are comfortable with an agent having exec capability to run simple shell commands and write files in ~/workspace/ (the skill asks the agent to use exec rather than asking you to run commands), (2) your platform limits what exec can do (so it can't access unrelated files or the network), and (3) you have backups of any existing ~/workspace/SOUL.md since the skill will offer to replace or save a draft. The skill does not request credentials or network access, and there are no downloads, but its runtime actions depend on the platform's exec sandboxing — verify those platform protections if you are concerned.
Capability Analysis
Type: OpenClaw Skill
Name: soul-md-maker
Version: 1.0.5
The OpenClaw AgentSkills skill bundle 'soul-md-maker' is classified as benign. While it utilizes powerful shell commands (`bash`, `sed`, `grep`) and performs file operations within the `~/workspace/` directory, the `SKILL.md` file includes extensive and explicit instructions for robust input sanitization, strict security boundaries (e.g., 'NEVER store, log, or share sensitive information', 'NEVER run system-modifying commands outside the workspace'), and clear disclaimers against network activity or persistence. The prompt injection instructions within `SKILL.md` are designed to guide the agent to follow these security protocols and the skill's stated purpose, rather than to subvert them. The skill explicitly defines what it reads and writes, limiting operations to `~/workspace/` and disclaiming any external network calls or persistence mechanisms.
Capability Assessment
Purpose & Capability
Name/description (SOUL.md Maker) match the requested capabilities: reading/writing SOUL.md and related example files and offering guided flows. Required binaries (bash, sed, grep) are reasonable for the filesystem checks and text operations the skill describes.
Instruction Scope
SKILL.md instructs the agent to run shell commands (ls, wc, etc.) via the platform exec tool, check ~/workspace/ file existence, read ~/workspace/SOUL.md only for audit/preview, and write SOUL.md/SOUL-draft.md/USER.md into ~/workspace/. This is within scope, but the skill explicitly requires the agent to execute commands rather than ask the user to run them — so the security posture depends on how the platform grants and constrains exec permissions.
Install Mechanism
Instruction-only skill with no install spec and no external downloads. Lowest install risk—nothing is written to disk by an installer beyond normal runtime file operations the skill itself performs.
Credentials
No environment variables, credentials, or config paths are requested. The only filesystem access described is to ~/workspace/, which is proportional to creating and auditing SOUL.md files.
Persistence & Privilege
always:false and no background/cron jobs. The skill writes only to the user's workspace (its stated persistence). It does not request system-wide changes or modify other skills' configurations.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install soul-md-maker - After installation, invoke the skill by name or use
/soul-md-maker - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.5
soul-md-maker v1.0.5
-Virus Total being a pain in the ass and flagging it as suspicious therefore a slight bump
- Version bump to 1.0.5.
- No file or content changes detected in this release.
v1.0.4
soul-md-maker v1.0.4
- Clarified environment detection in the documentation: file contents are only read during Soul Audit or SOUL.md preview, not during initial environment check.
- No functional or file changes; update is documentation-only for transparency and privacy assurance.
v1.0.3
soul-md-maker 1.0.3
- Updated SKILL.md to clarify that no authentication is needed (was previously "no credentials required").
- Minor update to metadata: wording adjustments for persistence and file handling.
- No functional or feature changes; documentation only.
v1.0.2
soul-md-maker 1.0.2 Changelog
- Environment detection now reports findings to the user before proceeding.
- Clarified file read/write rules for transparency; the skill never accesses file contents except when needed for Soul Audit or previews.
- Updated gallery rule: Only the 12 pre-built souls are available in the gallery, but Quick Build, Deep Build, and Blend modes can generate new custom souls.
- Mention of AI Persona OS website included when recommending users to expand their workspace.
- Documentation and agent instructions refined for improved user guidance and clear capabilities.
v1.0.1
- Added two new pre-built souls: "Gremlin — The Troll" and "Data — The Android", expanding the Soul Gallery from 10 to 12 personalities.
- Updated all references and menus to reflect the expanded gallery, including detailed mapping for gallery selection.
- Modified agent rules to accurately state "Only the 12 pre-built souls exist."
- Updated the Soul Gallery output and logic to showcase the full set of 12 personalities.
v1.0.0
SOUL.md Maker 1.0.0 — Initial Release
- Launches a personality builder for OpenClaw agents with 10 pre-built souls.
- Includes Quick and Deep Build options for guided custom soul creation.
- Features blending of two personalities and soul auditing.
- Detects environment (AI Persona OS, existing workspace, or fresh install) and handles files accordingly.
- Exports production-ready SOUL.md files and offers optional USER.md creation.
- Enforces strict agent rules for safety and consistency.
Metadata
Frequently Asked Questions
What is SOUL.md Maker?
SOUL.md Maker — the personality builder for OpenClaw agents. Browse 12 pre-built souls, build your own with a guided interview (Quick or Deep), blend persona... It is an AI Agent Skill for Claude Code / OpenClaw, with 978 downloads so far.
How do I install SOUL.md Maker?
Run "/install soul-md-maker" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is SOUL.md Maker free?
Yes, SOUL.md Maker is completely free (open-source). You can download, install and use it at no cost.
Which platforms does SOUL.md Maker support?
SOUL.md Maker is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created SOUL.md Maker?
It is built and maintained by Jeff J Hunter (@jeffjhunter); the current version is v1.0.5.
More Skills