soul-md-maker for Openclaw

A comprehensive personality builder for OpenClaw agents that generates production-ready SOUL.md files through guided interviews, blending, or a pre-built gallery.

jeffjhunter
v1.0.5
Feb 19, 2026
9
2.4k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install soul-md-maker

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install soul-md-maker using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is soul-md-maker?

soul-md-maker is a specialized tool designed to craft the identity and behavioral framework of AI agents. By generating a standardized SOUL.md file, it allows developers to define core truths, communication styles, and proactive behaviors. Whether you are using it standalone or as part of a larger ecosystem, this skill ensures your Openclaw Skills possess a consistent and engaging persona.

The tool bridges the gap between raw LLM logic and human-like interaction. It provides a structured way to enforce security boundaries and anti-patterns while allowing for creative expression through its unique Soul Gallery and deep interview processes. By establishing a clear soul, your agents become more predictable, efficient, and aligned with user expectations.

soul-md-maker Use Cases

  • Rapidly deploying a new agent with a pre-defined personality from the Soul Gallery.
  • Conducting a Deep Build interview to create a highly specialized assistant for niche business operations.
  • Auditing an existing SOUL.md file to ensure it meets quality standards and security requirements for Openclaw Skills.
  • Blending two distinct personalities to create a hybrid agent that balances contrasting traits like strategy and warmth.

How soul-md-maker Works

  1. The skill performs environment detection to check for AI Persona OS or existing OpenClaw workspaces.
  2. Users select a workflow from the main menu, such as browsing the gallery, starting a quick build, or a deep interview.
  3. The agent collects user preferences through targeted questions or by reading existing pre-built soul templates from the gallery.
  4. All inputs are sanitized to ensure security and prevent shell injection before being processed into a Markdown structure.
  5. The final SOUL.md file is written to the local workspace, ready for use by any agent following Openclaw Skills protocols.
  6. An optional audit can be performed to score the soul's effectiveness and suggest improvements.

soul-md-maker Setup

Install the skill into your OpenClaw environment. No external APIs or network calls are required as it operates entirely within your local workspace.

# Standard installation via OpenClaw CLI
openclaw install soul-md-maker

# Invoke the main menu to start building your persona
soul maker

soul-md-maker Data Schema & Taxonomy

The skill primarily manages the SOUL.md file within the ~/workspace/ directory. It uses a structured Markdown schema to ensure compatibility across different Openclaw Skills deployments.

File Name Purpose Description
SOUL.md Primary Identity Defines the agent's core truths, voice, and boundaries.
SOUL-draft.md Comparison Created when a user wants to test a new soul without overwriting the current one.
USER.md Companion Optional file for basic user context and preferences to support the soul.

soul-md-maker Advanced Features

  • Soul Blender: Mix any two personalities from the gallery to create unique hybrid identities with specific dominance weights.
  • Quality Litmus Test: Automated verification to ensure generated souls are specific enough to predict agent responses.
  • Automated Soul Audit: Scores existing identity files against 12 critical quality and security checkpoints.
  • Input Sanitization Engine: Built-in protection against shell metacharacters and malformed inputs during the creation process for Openclaw Skills.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins bashsedgrep
Github Stars: 0
forks: 0