soul-md-maker

What This Skill Does

SOUL.md Maker is the definitive personality orchestration tool for the OpenClaw ecosystem. Designed by Jeff J. Hunter, this skill serves as a structured creative engine that allows users to define, refine, and deploy the behavioral blueprint of their AI agents. At its core, the skill manages the production of the SOUL.md file—a specialized configuration document that dictates how your agent thinks, acts, and interacts with the world. Whether you need a highly professional consultant, a witty creative assistant, or a stoic analyst, this tool simplifies the complexity of persona engineering into a guided, interactive workflow.

Installation

To install this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/jeffjhunter/soul-md-maker

Once installed, the skill will integrate directly with your OpenClaw workspace. It performs an automatic environment detection check upon startup to determine if you are running a standalone setup or using the full AI Persona OS, ensuring that your existing configurations remain undisturbed and optimally formatted.

Use Cases

• Persona Rapid Prototyping: Use the 'Quick Build' interview to generate a functional personality within seconds, perfect for iterative testing.
• Depth-Oriented Design: Utilize 'Deep Build' to construct complex personas with nuanced behavioral constraints, tone-of-voice settings, and proactive triggers.
• Personality Blending: Combine attributes from multiple existing souls to create a hybrid agent, allowing for sophisticated personality experimentation.
• Audit & Review: Use the audit feature to analyze existing SOUL.md files, ensuring your current agent aligns with your evolving operational requirements.
• Standardization: Maintain consistent persona standards across multiple projects by using the library of 12 pre-built soul templates.

Example Prompts

1. "I'm ready to build a new agent. Can you launch the Deep Build interview so I can create a professional coding mentor persona?"
2. "I want to see the 12 pre-built souls you have available. Can you list them and show me a preview of the 'Logical Architect' profile?"
3. "I have an existing SOUL.md, but I'd like to blend it with a more creative tone. Can you help me audit my current file and start the blending process?"

Tips & Limitations

• Respect the Workspace: This skill only generates SOUL.md files. It does not modify system files like AGENTS.md or SECURITY.md. If you require a full-suite workspace manager, ensure you are utilizing the AI Persona OS.
• Always Check Environment: Allow the tool to run its initial ls detection commands. This ensures the skill knows exactly where to place your generated files without causing conflicts.
• Gallery Integrity: The pre-built gallery is static. You cannot add new files to the internal 'pre-built' list, but the custom builders allow for infinite personality creation.
• Safety First: The skill is designed to prevent accidental overwrites. If a file exists, always read the preview before confirming a replacement.